Skip to content

Invoke ePOWakeUpAgent

Raymond Piller edited this page Aug 26, 2020 · 2 revisions

external help file: ePOwerShell-help.xml Module Name: ePOwerShell online version: schema: 2.0.0

Invoke-ePOWakeUpAgent

SYNOPSIS

Wakes up the ePO Agent on specified computer

SYNTAX

Computer (Default)

Invoke-ePOWakeUpAgent [-Computer] <Object> [-ForceFullPolicyUpdate] [-FullProps] [-SuperAgent]
 [-AbortAfter <Int32>] [-RetryIntervalSeconds <Int32>] [-NumberOfAttempts <Int32>] [-RandomMinutes <Int32>]
 [<CommonParameters>]

AgentGuid

Invoke-ePOWakeUpAgent -AgentGuid <Object> [-ForceFullPolicyUpdate] [-FullProps] [-SuperAgent]
 [-AbortAfter <Int32>] [-RetryIntervalSeconds <Int32>] [-NumberOfAttempts <Int32>] [-RandomMinutes <Int32>]
 [<CommonParameters>]

DESCRIPTION

For each specified computer, the ePO server attempts to wake up the computer's agent and run policy updates.

EXAMPLES

Example 1

PS C:\> Invoke-ePOWakeUpAgent -ComputerName $ComputerName

Wake up a computer.

Example 2

PS C:\> @('Computer1', 'Computer2') | Invoke-ePOWakeUpAgent

Wake up a list of computers.

PARAMETERS

-Computer

Specifies the computer(s) to waking up. Can be provided as:

* An ePOComputer object
* A computer name

This parameter can be passed in from the pipeline.

Type: Object
Parameter Sets: Computer
Aliases: ComputerName

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-AgentGuid

{{ Fill AgentGuid Description }}

Type: Object
Parameter Sets: AgentGuid
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceFullPolicyUpdate

Updates the agent with all polices and properties

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-FullProps

Full properties will be sent by Agent.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-SuperAgent

Allows you to use a SuperAgent to broadcast wakeup calls to other agents.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-AbortAfter

Specifies total number of minutes it should wait for an agent to respond before it considers the attempt a failure.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 5
Accept pipeline input: False
Accept wildcard characters: False

-RetryIntervalSeconds

Specifies how long it should wait between attempts if the previous attempt to wake up an agent failed.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 30
Accept pipeline input: False
Accept wildcard characters: False

-NumberOfAttempts

Specifies how many times the ePO server should attempt to wake up the agent before it deems it a failure.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 1
Accept pipeline input: False
Accept wildcard characters: False

-RandomMinutes

Specifies number of minutes to randomise the wakeup calls

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS