Public/Update-AvdScheduledAgentsUpdate.ps1
|
function Update-AvdScheduledAgentsUpdate { <# .SYNOPSIS Updates the scheduled agents update settings. .DESCRIPTION Updates the scheduled agents update settings in an Azure Virtual Desktop hostpool. .PARAMETER HostpoolName Enter the AVD Hostpool name .PARAMETER ResourceGroupName Enter the AVD Hostpool resourcegroup name .PARAMETER TimeZone Fill in a custom timezone, otherwise the session host's timezone is used .PARAMETER DayOfWeek Monday, Tuesday, etc. .PARAMETER Hour Provide an hour between 0-24 hours .PARAMETER ExtraDayOfWeek Extra schedule on Monday, Tuesday, etc. .PARAMETER ExtraHour Extra hour between 0-24 .EXAMPLE Update-AvdScheduledAgentsUpdate -HostpoolName avd-hostpool -ResourceGroupName rg-avd-01 -DayOfWeek Sunday -Hour 2 .EXAMPLE Update-AvdScheduledAgentsUpdate -HostpoolName avd-hostpool -ResourceGroupName rg-avd-01 -DayOfWeek Sunday -Hour 2 -ExtraDayOfWeek Monday -ExtraHour 5 .EXAMPLE Update-AvdScheduledAgentsUpdate -HostpoolName avd-hostpool -ResourceGroupName rg-avd-01 -DayOfWeek Sunday -Hour 2 -Timezone "W. Europe Standard Time" #> [CmdletBinding(DefaultParameterSetName = "UserLocalTimeZone")] param ( [parameter(Mandatory)] [ValidateNotNullOrEmpty()] [string]$HostpoolName, [parameter(Mandatory)] [ValidateNotNullOrEmpty()] [string]$ResourceGroupName, [parameter()] [ValidateNotNullOrEmpty()] [string]$TimeZone, [parameter(Mandatory)] [ValidateNotNullOrEmpty()] [ValidateSet("Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday")] [string]$DayOfWeek, [parameter(Mandatory)] [ValidateNotNullOrEmpty()] [ValidatePattern('2[0-4]|1[0-9]|[1-9]')] [int]$Hour, [parameter(Mandatory, ParameterSetName = "AdditionalSchedule")] [ValidateNotNullOrEmpty()] [ValidateSet("Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday")] [string]$ExtraDayOfWeek, [parameter(Mandatory, ParameterSetName = "AdditionalSchedule")] [ValidateNotNullOrEmpty()] [ValidatePattern('2[0-4]|1[0-9]|[1-9]')] [int]$ExtraHour ) Begin { Write-Verbose "Start searching" AuthenticationCheck $token = GetAuthToken -resource $Script:AzureApiUrl $url = "{0}/subscriptions/{1}/resourceGroups/{2}/providers/Microsoft.DesktopVirtualization/hostpools/{3}?api-version={4}" -f $Script:AzureApiUrl, $script:subscriptionId, $ResourceGroupName, $HostpoolName, $script:hostpoolApiVersion $parameters = @{ uri = $url Headers = $token } } Process { if ($TimeZone) { $maintenanceWindowTimeZone = $TimeZone $useSessionHostLocalTime = $false } else { Write-Verbose "Local timezone used." $maintenanceWindowTimeZone = $null $useSessionHostLocalTime = $true } $body = @{ properties = @{ agentUpdate = @{ type = "Scheduled" maintenanceWindowTimeZone = $maintenanceWindowTimeZone useSessionHostLocalTime = $useSessionHostLocalTime maintenanceWindows = @( @{ dayOfWeek = $DayOfWeek hour = $Hour } ) } } } if ($PSCmdlet.ParameterSetName -eq "AdditionalSchedule") { $additionalSchedule = @( @{ dayOfWeek = $ExtraDayOfWeek hour = $ExtraHour } ) $body.properties.maintenanceWindows += $additionalSchedule } $jsonBody = $body | ConvertTo-Json -Depth 5 $jsonBody $parameters = @{ uri = $url Method = "PATCH" Headers = $token Body = $jsonBody } try { $results = Invoke-RestMethod @parameters } catch { Throw $_ } $results } } |