Modifies settings of a Provider server.
For each setting, the cmdlet includes a corresponding input parameter. To modify a setting, specify a parameter and its value.
PARAMETERS
-Name <string>
The name of the Provider.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SiteId <uint>
Site ID in which to modify the specified Provider server.
If the parameter is omitted, the site ID of the Licensing Server will be used.
Required? false
Position? 1
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-Id <uint>
The ID of the Provider server to modify. To obtain the ID, use the Get-RASProvider cmdlet.
Required? true
Position? 0
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
Required? true
Position? 0
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false
-Enabled <bool>
Enables or disables the specified Provider server in a site.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-NewName <string>
A new name for the Provider.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-NewServer <string>
The name of the target Provider server.
This must be the actual server name used in the RAS farm.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <string>
A user-defined Provider server description.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DirectAddress <string>
Specifies the Provider server direct address.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Port <uint>
Specifies the port number for the RAS VDI Agent.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-VDIAgent <string>
FQDN or IP address of the server where the RAS VDI Agent is running.
You only need to specify this parameter if the RAS VDI Agent is dedicated.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SupportShellURLNamespaceObjects <bool>
Enable or disable the 'Support Shell URL Namespace Objects' option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AllowDragAndDrop <bool>
Set the Drag and Drop option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AllowFileTransfer <bool>
Deprecated: use FileTransferMode instead.
Enable or disable the 'Allow file transfer' option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-FileTransferLocation <string>
Location where the File Transfer takes place, if and where it is allowed.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-FileTransferLockLocation <bool>
Lock Location where the File Transfer takes place, if and where it is allowed.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RemoveClientNameFromPrinterName <bool>
Enable or disable the 'Remove client name from printer name' option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RemoveSessionNumberFromPrinterName <bool>
Enable or disable the 'Remove session number from printer name' option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AutoPreferredBroker <SwitchParameter>
Set the 'Preferred Connection Broker' option to 'Automatically". If number of Connection Brokers is less than 3 then preferred Conection Broker is not allowed to choose automatic.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-EnableDriveRedirectionCache <bool>
Enable or disable the 'Enable Drive Redirection Cache' option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProviderUsername <string>
A user account to log in to the hypervisor management tool (e.g. VMware vCenter).
In case of Azure, it is an ID of the application which will be used by VDI agent to manage Azure resources.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProviderPassword <SecureString>
The password of the account specified in the ProviderUsername parameter.
In case of Azure, it is a secret key of the application which will be used by VDI agent to manage Azure resources.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-VDIPort <uint>
The port to communicate with the dedicated VDIAgent specified in the VDIAgent parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PreferredBrokerId <uint>
The preferred Connection Broker ID.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-UseAllGuests <bool>
Use all guests.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CostOptimizeTimeout <uint>
Cost Optimize Timeout in seconds. Applicable to: AVD (Experimental) and Azure.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EnableCostOptimize <bool>
Enable Cost Optimize. Applicable to: AVD (Experimental) and Azure.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-FeedURL <string>
The Feed URL. Applicable to: AVD (Experimental).
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WebAccessURL <string>
The Web Access URL. Applicable to: AVD (Experimental).
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AccessKeyID <string>
The access key ID of the Amazon Web Service account. Applicable to: AWSEC2.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecretAccessKey <SecureString>
The secret access key of the Amazon Web Service account. Applicable to: AWSEC2.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RegionName <string>
The region name of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RegionCode <string>
The region code of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EndpointUrl <string>
The endpoint URL of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.
Example: https://ec2.us-east01.amazonaws.com.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-StartMacAddress <string>
Starting MAC Address. Applicable to: HyperV Failover.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EndMacAddress <string>
Ending MAC Address. Applicable to: HyperV Failover.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EnableMacManagement <bool>
Specifies if the MAC Management is enabled or not. Applicable to: HyperV Failover.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DomainTargetOU <string>
Domain Target OU. Applicable to: Remote PC Dynamic.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-RemotePCDynamicSubnet <string>
The subnet of the remote PC dynamic. Applicable to: Remote PC Dynamic.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ResourcePool <string>
Resource Pool. Applicable to: VCenter
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters .
INPUTS
OUTPUTS
-none-
EXAMPLES
---------- EXAMPLE 1 ----------
Set-RASProvider -Server "server.company.dom" -Enabled $False
Disables the specified Provider server in the Licensing Server site.
---------- EXAMPLE 2 ----------
Set-RASProvider -Id 3 -Enabled $False
Disables the Provider server specified by ID.
---------- EXAMPLE 3 ----------
Set-RASProvider $Provider -Enabled $True
Enables the Provider server specified by the $Provider variable, which is an object of type Provider.
The object is obtained using the Get-RASProvider cmdlet.
---------- EXAMPLE 4 ----------
Set-RASProvider $Provider -VCenter -ResourcePool "ResourcePool"
Sets the ResourcePool of the VCenter Provider server specified by the $Provider variable.
The object is obtained using the Get-RASProvider cmdlet.
---------- EXAMPLE 5 ----------
Get-RASProvider -Id 3 | Set-RASProvider -Enabled $True
Enables the Provider server represented by a Provider object obtained from the pipeline output.
-InputObject <>
An object representing the Provider server to modify.
To obtain the object, use the Get-RASProvider cmdlet.
-AllowURLAndMailRedirection <>
Set the URL and Mail Redirection option. Possible values: 0 = Disabled, 1 = Enabled, 2 = Enabled with application registration.
Possible values: Disabled, Enabled, EnabledWithAppRegistration
-FileTransferMode <>
File Transfer option. Possible values are: 0 (Disabled), 1 (client to Server only), 2 {Server To Client only), 3 (Bidirectional).
Possible values: Disabled, ClientToServer, ServerToClient, Bidirectional
-PrinterNameFormat <>
Specifies the 'RDP Printer Name Format' option.
Possible values: PrnFormat_PRN_CMP_SES, PrnFormat_SES_CMP_PRN, PrnFormat_PRN_REDSES
-ManageRDPTransportProtocol <>
Manage RDP transport protocol.
Possible values: Disabled, BothUDPTCP, OnlyTCP, EitherUDPTCP
-PreferredBrokerObj <>
The preferred Connection Broker server.
To obtain an object of type Broker representing the preferred Connection Broker, use the Get-RASBroker cmdlet.
-ADType <>
The ADType. Applicable to: AVD (Experimental).
Possible values: WindowsServerADDS, AzureADDS
-LocationType <>
The location type of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.
Possible values: Default, OptedIn, EndpointUrl
