New-Vusmachineupgrade¶
Creates a new schedule for a machine or list of machines
Syntax¶
New-VusMachineUpgrade -ScheduledTimeInUtc <DateTime> -DurationInHours <Int32> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]<br><br>New-VusMachineUpgrade -ScheduledTimeInUtc <DateTime> -DurationInHours <Int32> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]<br><br>New-VusMachineUpgrade -ScheduledTimeInUtc <DateTime> -DurationInHours <Int32> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]<br><br>New-VusMachineUpgrade -UpgradeNow -DurationInHours <Int32> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]<br><br>New-VusMachineUpgrade -UpgradeNow -DurationInHours <Int32> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]<br><br>New-VusMachineUpgrade -UpgradeNow -DurationInHours <Int32> [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]
Detailed Description¶
The New-VusMachineUpgrade cmdlet creates a new schedule for a machine or list of machines.
The cmdlet syncs with broker service to determine if the machine actually is added to broker service and only then schedules the upgrade for it.
Related Commands¶
Parameters¶
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| ScheduledTimeInUtc | Scheduled time in UTC when machine upgrade occurs | true | false | |
| DurationInHours | Hours available for upgrade | true | false | |
| UpgradeNow | Switch to start upgrade at current time in UTC | true | false | |
| BearerToken | Specifies the bearer token assigned to the calling user | false | false | |
| TraceParent | Specifies the trace parent assigned for internal diagnostic tracing use | false | false | |
| TraceState | Specifies the trace state assigned for internal diagnostic tracing use | false | false | |
| VirtualSiteId | Specifies the virtual site the PowerShell snap-in will connect to. | false | false | |
| AdminAddress | Specifies the address of a XenDesktop controller the PowerShell snap-in will connect to. You can provide this as a host name or an IP address. | false | false | Localhost. Once a value is provided by any cmdlet, this value becomes the default. |
Input Type¶
System.Guid¶
Return Values¶
Citrix.Vdaupdateservice.Sdk.Machinescheduleobject¶
Upgrade information for most recent machine schedule
Examples¶
Example 1¶
C:\PS> NewVusMachineUpgrade -MachineUuid "26C82B4E-A8E7-4013-8055-9110FD9FFDC9" -ScheduledTimeInUtc ([System.DateTime]::ParseExact("10/23/2021 07:00 PM", 'MM/dd/yyyy hh:mm tt', $null)) -DurationInHours 4
Description¶
Create a new upgrade for the machine matching the given UUID.
Example 2¶
C:\PS> NewVusMachineUpgrade -MachineUuid "26C82B4E-A8E7-4013-8055-9110FD9FFDC9" -UpgradeNow -DurationInHours 4
Description¶
Create a new upgrade for the machine matching the given UUID.