Set-RASAVDHostPool
Last updated
Last updated
Set-RASAVDHostPool
Modifies a Azure Virtual Desktop Host Pool.
Set-RASAVDHostPool [-] <uint> [- <bool>] [- {Disabled | Enabled | EnabledWithAppRegistration}] [- <bool>] [- <bool>] [- {DoNotConfigure | WindowsClient | WindowsServer}] [- {PoweredOn | PoweredOff | Suspended}] [- <string>] [- <uint>] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- <uint>] [- <bool>] [- <bool>] [- <string>] [- <bool>] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- <string>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- {BreadthFirst | DepthFirst | Persistent}] [- <uint>] [- <bool>] [- {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [- <uint>] [- <uint>] [- <uint>] [- <uint>] [- <string>] [- <bool>] [- {DoNothing | Shutdown | Suspend | Delete | Restart | Unassign | Recreate}] [- <uint>] [- <bool>] [- {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- {Disconnect | Logoff}] [- <uint>] [- <bool>] [- {DoNotManage | UPD | FSLogix | FSLogixProfileContainer}] [- <uint>] [- <uint>] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- <uint>] [<>] Set-RASAVDHostPool [-] <> [- <bool>] [- {Disabled | Enabled | EnabledWithAppRegistration}] [- <bool>] [- <bool>] [- {DoNotConfigure | WindowsClient | WindowsServer}] [- {PoweredOn | PoweredOff | Suspended}] [- <string>] [- <uint>] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- <uint>] [- <bool>] [- <bool>] [- <string>] [- <bool>] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- <string>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- {BreadthFirst | DepthFirst | Persistent}] [- <uint>] [- <bool>] [- {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [- <uint>] [- <uint>] [- <uint>] [- <uint>] [- <string>] [- <bool>] [- {DoNothing | Shutdown | Suspend | Delete | Restart | Unassign | Recreate}] [- <uint>] [- <bool>] [- {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- {Disconnect | Logoff}] [- <uint>] [- <bool>] [- {DoNotManage | UPD | FSLogix | FSLogixProfileContainer}] [- <uint>] [- <uint>] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- <uint>] [<>] Set-RASAVDHostPool [-] <string> [[-] <uint>] [- <bool>] [- {Disabled | Enabled | EnabledWithAppRegistration}] [- <bool>] [- <bool>] [- {DoNotConfigure | WindowsClient | WindowsServer}] [- {PoweredOn | PoweredOff | Suspended}] [- <string>] [- <uint>] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- <uint>] [- <bool>] [- <bool>] [- <string>] [- <bool>] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- <string>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- {BreadthFirst | DepthFirst | Persistent}] [- <uint>] [- <bool>] [- {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [- <uint>] [- <uint>] [- <uint>] [- <uint>] [- <string>] [- <bool>] [- {DoNothing | Shutdown | Suspend | Delete | Restart | Unassign | Recreate}] [- <uint>] [- <bool>] [- {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- {Disconnect | Logoff}] [- <uint>] [- <bool>] [- {DoNotManage | UPD | FSLogix | FSLogixProfileContainer}] [- <uint>] [- <uint>] [- <bool>] [- <bool>] [- <bool>] [- <uint>] [- <uint>] [<>]
Modifies properties of a Azure Virtual Desktop Host Pool. This is an Experimental feature which is subject to slight changes.
-Id <uint> ID for which to modify the Azure Virtual Desktop Host Pool settings.
-Name <string> The name of the target Azure Virtual Desktop Host Pool settings. This must be the actual Azure Virtual Desktop Host Pool name used in the RAS farm.
-SiteId <uint> Site ID in which to modify the specified Azure Virtual Desktop Host Pool settings . If the parameter is omitted, the site ID of the Licensing Server will be used.
-NewName <string> The new name of the Azure Virtual Desktop Host Pool settings.
-Description <string> The new description of the Azure Virtual Desktop Host Pool settings.
-Enabled <bool> Enable or disable the specified AVD Host Pool in a site.
-PowerOnHost <bool> Whether Power On Host is Enabled or not.
-ValidationEnvironment <bool> Whether Validation Environment is Enabled or not.
-LimitHosts <uint> The Limit of session on host.
-DisconnectActiveSessionAfter <uint> Disconnect active session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'.
-LogoffDisconnectedSessionAfter <uint> Logoff disconnected session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'; 1 for 'Immediate'.
-SessionReadinessTimeout <uint> Session readiness timeout (in seconds). Accepted values: 20-3600 seconds.
-AllowRemoteExec <bool> Specifies if 'Allow 2XRemoteExec to send command to the client' option is enabled or disabled.
-SupportShellURLNamespaceObjects <bool> Specifies if 'Support Shell URL Namespace Objects' option is enabled or disabled.
-FileTransferLocation <string> Location where the File Transfer takes place, if and where it is allowed.
-FileTransferLockLocation <bool> Lock Location where the File Transfer takes place, if and where it is allowed.
-EnableDriveRedirectionCache <bool> Specifies if the 'Enable Drive Redirection Cache' option is enabled or disabled.
-PerformActionAfterSec <uint> Perform action after (in seconds)
-TemplateId <uint> The Template ID.
-TemplateVersionId <uint> The RAS Template Version ID.
-AutoScaleEnabled <bool> Whether AutoScale is Enabled or not.
-MinServersFromTemplate <uint> The Minimum Number of Hosts added to the template.
-MaxServersFromTemplate <uint> The Maximum Number of Hosts added to the template.
-HostName <string> The Host name format. All VMs created from the template will have this name with %ID:N:S% replaced.
-WorkloadThreshold <uint> The Workload Threshold.
-ServersToAddPerRequest <uint> The amount of servers to add per request.
-WorkLoadDrain <uint> The Drain Workload.
-DrainRemains <uint> The Remaining Drain level.
-OverwriteSize <bool> The Remaining Drain level.
-RemoveServersAfterDrainAndPowerOff <bool> Remove hosts from host pool after drain and power off.
-RemoveSessionNumberFromPrinterName <bool> Specifies if 'Remove session number from printer name' option is enabled or disabled.
-RemoveClientNameFromPrinterName <bool> Specifies if 'Remove client name from printer name' option is enabled or disabled.
-AppMonitor <bool> Specifies if 'Allow Application Monitoring' option is enabled or disabled.
-ManageRDPShortpath <bool> Specifies if 'Allow RDP Shortpath' option is enabled or disabled.
-UseRDPShortpath <bool> Specifies if 'Allow RDP Shortpath' option is enabled or disabled.
-UseSmallerPortRange <bool> Specifies if 'Use Smaller Port' option is enabled or disabled.
-MinRDPShortpathPort <uint> The minimum RDP Shortpath Port.
-MaxRDPShortpathPort <uint> The maximum RDP Shortpath Port.
-InheritDefaultAgentSettings <bool> If true, default AVD Agent settings will be inherited.
-InheritDefaultUserProfileSettings <bool> If true, default User Profile settings will be inherited.
-InheritDefaultAppPackageSettings <bool> If true, default Application Package settings will be inherited.
-InheritDefaultOptimizationSettings <bool> If true, default Optimization settings will be inherited.
-InheritDefaultActionsSettings <bool> If true, default Action settings will be inherited.
-InheritDefaultRDPPrinterSettings <bool> If true, default Printing settings will be inherited.
<CommonParameters>
-none-
---------- EXAMPLE 1 ---------- Set-RASAVDHostPool -NewName NewHostPool Modifies the name of the Azure Virtual Desktop Host Pool.
-InputObject <> An AVD Host Pool object (an object of type AVDHostPool) to modify. An AVDHostPool object representing a host pool is obtained using the Get-RASAVDHostPool cmdlet.
-DefaultLicenseType <> The license type. Possible values: DoNotConfigure, WindowsClient, WindowsServer
-LoadBalancerType <> The Load Balancer Type of the Host Pool Possible values: BreadthFirst, DepthFirst, Persistent
-Technology <> Specifies the 'User Profile Technology' value. Possible values: DoNotManage, UPD, FSLogix, FSLogixProfileContainer
-AllowURLAndMailRedirection <> Specifies the 'Allow Client URL/Mail Redirection'. Possible values: Disabled, Enabled, EnabledWithAppRegistration
-ManageRDPTransportProtocol <> Manage RDP transport protocol. Possible values: Disabled, BothUDPTCP, OnlyTCP, EitherUDPTCP
-DragAndDropMode <> Specifies the mode the drag and drop feature will operate. Possible values: Disabled, ClientToServer, ServerToClient, Bidirectional
-FileTransferMode <> Specifies if File Transfer option is allowed and if yes, which directions are allowed. Possible values: Disabled, ClientToServer, ServerToClient, Bidirectional
-SessionAction <> Session Action Possible values: Disconnect, Logoff
-PerformAction <> Perform Action Possible values: DoNothing, Shutdown, Suspend, Delete, Restart, Unassign, Recreate
-DefaultPowerState <> The Default Power State Possible values: PoweredOn, PoweredOff, Suspended
-PrinterNameFormat <> Specifies the 'Printer Name Format' option. Possible values: PrnFormat_PRN_CMP_SES, PrnFormat_SES_CMP_PRN, PrnFormat_PRN_REDSES