Citrix Virtual Apps and Desktops SDK

Remove-VusMachineUpgrade

Introduced in: Citrix Virtual Apps and Desktop 7 2411

Deletes a scheduled upgrade for a specific machine/list of machines

Syntax

Remove-VusMachineUpgrade
      -MachineName <String[]>
      [-Force]
      [-LoggingId <Guid>]
      [-SkipCertificateValidation]
      [<CitrixCommonParameters>]
      [<CommonParameters>]
<!--NeedCopy-->
Remove-VusMachineUpgrade
      -MachineUid <Int32[]>
      [-Force]
      [-LoggingId <Guid>]
      [-SkipCertificateValidation]
      [<CitrixCommonParameters>]
      [<CommonParameters>]
<!--NeedCopy-->
Remove-VusMachineUpgrade
      -MachineUuid <String[]>
      [-Force]
      [-LoggingId <Guid>]
      [-SkipCertificateValidation]
      [<CitrixCommonParameters>]
      [<CommonParameters>]
<!--NeedCopy-->

Description

The Remove-VusMachineUpgrade cmdlet deletes the scheduled upgrade for a specific machine or list of machines.

To cancel machines within scheduled duration, use the Force switch.

Examples

EXAMPLE 1

Delete a scheduled upgrade for a specific machine specified by UUID.

Remove-VusMachineUpgrade -MachineUuid "26C82B4E-A8E7-4013-8055-9110FD9FFDC9"
<!--NeedCopy-->

EXAMPLE 2

Delete a scheduled upgrade for the machine with the name specified by MachineName.

Remove-VusMachineUpgrade -MachineName "TestMachine1"
<!--NeedCopy-->

Parameters

-MachineUuid

UUID of the machine or list of machines

Type: String[]
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-MachineName

Name of the machine or list of machines

Type: String[]
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-MachineUid

UID of the machine or list of machines

Type: Int32[]
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-Force

Removes machine schedules in upgrade window

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

-LoggingId

Specifies the identifier of the high-level operation this cmdlet call forms a part of. Citrix Studio and Director typically create high-level operations. PowerShell scripts can also wrap a series of cmdlet calls in a high-level operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets.

Type: Guid
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False
Introduced in: Citrix Virtual Apps and Desktop 7 2507

-SkipCertificateValidation

Forces the cmdlet to skip checking SSL certificates. By default, the cmdlet will check the certificate from the server. If the certificate is not valid, the cmdlet will not connect to the server.

Type: SwitchParameter
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False
Introduced in: Citrix Virtual Apps and Desktop 7 2511

CitrixCommonParameters

This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.

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

Guid

Outputs

None

By default, this cmdlet returns no output.

Remove-VusMachineUpgrade