Set-PAPriority

Set-PAPriority

Change the priority of a RAS Publishing Agent server.

Set-PAPriority [-Server] <string> [[-SiteId] <uint>] -Direction <MoveDirection> {Up | Down} [<CommonParameters>]

Set-PAPriority [-Id] <uint> -Direction <MoveDirection> {Up | Down} [<CommonParameters>]

Set-PAPriority [-InputObject] <PA> -Direction <MoveDirection> {Up | Down} [<CommonParameters>]

Changes the priority of a RAS Publishing Agent by moving it up or down in the priority list.

-Server <string>
The name of the RAS Publishing Agent server.

This must be the actual server name used in the Parallels RAS farm.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint>
Site ID of the RAS Publishing Agent server.

If the parameter is omitted, the Licensing Server site ID will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint>
The ID of the RAS Publishing Agent server.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <PA>
An object of type PA representing the RAS Publishing Agent.

To obtain the object, use the Get-PA cmdlet.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

-Direction <MoveDirection>
The direction to move the PA object: Up or Down (changes the priority of the Publishing Agent accordingly).

Possible values: Up, Down

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

PA

---------- EXAMPLE 1 ----------

Set-PAPriority -Id 5 -Direction Up

Changes the priority of the specified (by ID) RAS Publishing Agent server (moving 1 priority up).

---------- EXAMPLE 2 ----------

Set-PAPriority -InputObject $PA -Direction Down

Changes the priority of the specified (by InputObject) RAS Publishing Agent server (moving 1 priority down).