> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-rasprovider.md).

# Set-RASProvider

## SYNOPSIS

Modifies Provider server settings.

## SYNTAX

```powershell
Set-RASProvider [-Id] <uint> [-AccessKeyID <string>]
 [-ADType {ActiveDirectoryDomainServicesObjectGuid | ActiveDirectoryDomainServicesObjectGuidString | MicrosoftEntraDomainServices | WindowsServerADDS | AzureADDS}]
 [-AllowDragAndDrop <bool>]
 [-AllowURLAndMailRedirection {Disabled | Enabled | EnabledWithAppRegistration}]
 [-Arguments <string>] [-AutoPreferredConnectionBroker <SwitchParameter>]
 [-CollectCostsForThisProvider <bool>] [-Command <string>] [-CostInsightsAppID <string>]
 [-CostInsightsAppKey <SecureString>] [-CostOptimizeTimeout <uint>] [-Description <string>]
 [-DirectAddress <string>] [-DomainTargetOU <string>]
 [-DriveRedirectionFileCache {None | ReadAhead | ReadAheadWriteBehind}] [-EnableCostOptimize <bool>]
 [-Enabled <bool>] [-EnableDriveRedirectionCache <bool>] [-EnableMacManagement <bool>]
 [-EndMacAddress <string>] [-EndpointUrl <string>] [-FeedURL <string>]
 [-FileTransferAutoCloseWindow <bool>]
 [-FileTransferExistingFileMode {CreateNewFile | OverwriteExistingFile}]
 [-FileTransferLocation <string>] [-FileTransferLockLocation <bool>]
 [-FileTransferMode {Disabled | ClientToServer | ServerToClient | Bidirectional}]
 [-FileTransferSuppressPromptForUploadFiles <bool>]
 [-HyperVFailoverVersion {HyperVFailoverCluster | Ent | Dtc | Win2012 | Win2012R2 | Win2016 | Win2019 | Win2022 | Win2025}]
 [-HyperVVersion {HyperV | Win2012R2Std | Win2012R2Dtc | Win2012R2Srv | Win2016Std | Win2016Dtc | Win2016Srv | Win2019Std | Win2019Dtc | Win2019Srv | Win2022Std | Win2022Dtc | Win2022DtcAzure | Win2025Std | Win2025Dtc | Win2025DtcAzure}]
 [-LocationType {Default | OptedIn | EndpointUrl}]
 [-ManageRDPTransportProtocol {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [-NewName <string>]
 [-NewServer <string>] [-NutanixPCVersion {NutanixPC | v7_3 | v7_5}]
 [-NutanixVersion {Nutanix | v5_15 | v5_20 | v6_5 | v6_10 | v7_3}] [-Port <uint>]
 [-PreferredConnectionBrokerId <uint>] [-PreferredConnectionBrokerObj <ConnectionBroker>]
 [-PrinterNameFormat {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}]
 [-ProviderPassword <SecureString>] [-ProviderUsername <string>] [-RegionCode <string>]
 [-RegionName <string>] [-RemotePCDynamicSubnet <string>] [-RemoveClientNameFromPrinterName <bool>]
 [-RemoveSessionNumberFromPrinterName <bool>] [-ResourcePool <string>] [-ResourcePoolID <string>]
 [-ScaleVersion {Scale | v9_4 | v9_6}] [-SecretAccessKey <SecureString>] [-StartMacAddress <string>]
 [-SupportShellURLNamespaceObjects <bool>] [-UseAllGuests <bool>] [-UseSameAppRegAsProvider <bool>]
 [-VCenterVersion {VmwareVCenter | v6_5 | v6_7 | v7_0 | v8_0 | v9_0 | v9_1}] [-VDIAgent <string>]
 [-VDIPort <uint>] [-VmwareESXiVersion {VmwareESXi | v6_5 | v6_7 | v7_0 | v8_0 | v9_0 | v9_1}]
 [-WebAccessURL <string>] [-Workdir <string>] [<CommonParameters>]
```

```powershell
Set-RASProvider [-InputObject] <Provider> [-AccessKeyID <string>]
 [-ADType {ActiveDirectoryDomainServicesObjectGuid | ActiveDirectoryDomainServicesObjectGuidString | MicrosoftEntraDomainServices | WindowsServerADDS | AzureADDS}]
 [-AllowDragAndDrop <bool>]
 [-AllowURLAndMailRedirection {Disabled | Enabled | EnabledWithAppRegistration}]
 [-Arguments <string>] [-AutoPreferredConnectionBroker <SwitchParameter>]
 [-CollectCostsForThisProvider <bool>] [-Command <string>] [-CostInsightsAppID <string>]
 [-CostInsightsAppKey <SecureString>] [-CostOptimizeTimeout <uint>] [-Description <string>]
 [-DirectAddress <string>] [-DomainTargetOU <string>]
 [-DriveRedirectionFileCache {None | ReadAhead | ReadAheadWriteBehind}] [-EnableCostOptimize <bool>]
 [-Enabled <bool>] [-EnableDriveRedirectionCache <bool>] [-EnableMacManagement <bool>]
 [-EndMacAddress <string>] [-EndpointUrl <string>] [-FeedURL <string>]
 [-FileTransferAutoCloseWindow <bool>]
 [-FileTransferExistingFileMode {CreateNewFile | OverwriteExistingFile}]
 [-FileTransferLocation <string>] [-FileTransferLockLocation <bool>]
 [-FileTransferMode {Disabled | ClientToServer | ServerToClient | Bidirectional}]
 [-FileTransferSuppressPromptForUploadFiles <bool>]
 [-HyperVFailoverVersion {HyperVFailoverCluster | Ent | Dtc | Win2012 | Win2012R2 | Win2016 | Win2019 | Win2022 | Win2025}]
 [-HyperVVersion {HyperV | Win2012R2Std | Win2012R2Dtc | Win2012R2Srv | Win2016Std | Win2016Dtc | Win2016Srv | Win2019Std | Win2019Dtc | Win2019Srv | Win2022Std | Win2022Dtc | Win2022DtcAzure | Win2025Std | Win2025Dtc | Win2025DtcAzure}]
 [-LocationType {Default | OptedIn | EndpointUrl}]
 [-ManageRDPTransportProtocol {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [-NewName <string>]
 [-NewServer <string>] [-NutanixPCVersion {NutanixPC | v7_3 | v7_5}]
 [-NutanixVersion {Nutanix | v5_15 | v5_20 | v6_5 | v6_10 | v7_3}] [-Port <uint>]
 [-PreferredConnectionBrokerId <uint>] [-PreferredConnectionBrokerObj <ConnectionBroker>]
 [-PrinterNameFormat {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}]
 [-ProviderPassword <SecureString>] [-ProviderUsername <string>] [-RegionCode <string>]
 [-RegionName <string>] [-RemotePCDynamicSubnet <string>] [-RemoveClientNameFromPrinterName <bool>]
 [-RemoveSessionNumberFromPrinterName <bool>] [-ResourcePool <string>] [-ResourcePoolID <string>]
 [-ScaleVersion {Scale | v9_4 | v9_6}] [-SecretAccessKey <SecureString>] [-StartMacAddress <string>]
 [-SupportShellURLNamespaceObjects <bool>] [-UseAllGuests <bool>] [-UseSameAppRegAsProvider <bool>]
 [-VCenterVersion {VmwareVCenter | v6_5 | v6_7 | v7_0 | v8_0 | v9_0 | v9_1}] [-VDIAgent <string>]
 [-VDIPort <uint>] [-VmwareESXiVersion {VmwareESXi | v6_5 | v6_7 | v7_0 | v8_0 | v9_0 | v9_1}]
 [-WebAccessURL <string>] [-Workdir <string>] [<CommonParameters>]
```

```powershell
Set-RASProvider [-Name] <string> [[-SiteId] <uint>] [-AccessKeyID <string>]
 [-ADType {ActiveDirectoryDomainServicesObjectGuid | ActiveDirectoryDomainServicesObjectGuidString | MicrosoftEntraDomainServices | WindowsServerADDS | AzureADDS}]
 [-AllowDragAndDrop <bool>]
 [-AllowURLAndMailRedirection {Disabled | Enabled | EnabledWithAppRegistration}]
 [-Arguments <string>] [-AutoPreferredConnectionBroker <SwitchParameter>]
 [-CollectCostsForThisProvider <bool>] [-Command <string>] [-CostInsightsAppID <string>]
 [-CostInsightsAppKey <SecureString>] [-CostOptimizeTimeout <uint>] [-Description <string>]
 [-DirectAddress <string>] [-DomainTargetOU <string>]
 [-DriveRedirectionFileCache {None | ReadAhead | ReadAheadWriteBehind}] [-EnableCostOptimize <bool>]
 [-Enabled <bool>] [-EnableDriveRedirectionCache <bool>] [-EnableMacManagement <bool>]
 [-EndMacAddress <string>] [-EndpointUrl <string>] [-FeedURL <string>]
 [-FileTransferAutoCloseWindow <bool>]
 [-FileTransferExistingFileMode {CreateNewFile | OverwriteExistingFile}]
 [-FileTransferLocation <string>] [-FileTransferLockLocation <bool>]
 [-FileTransferMode {Disabled | ClientToServer | ServerToClient | Bidirectional}]
 [-FileTransferSuppressPromptForUploadFiles <bool>]
 [-HyperVFailoverVersion {HyperVFailoverCluster | Ent | Dtc | Win2012 | Win2012R2 | Win2016 | Win2019 | Win2022 | Win2025}]
 [-HyperVVersion {HyperV | Win2012R2Std | Win2012R2Dtc | Win2012R2Srv | Win2016Std | Win2016Dtc | Win2016Srv | Win2019Std | Win2019Dtc | Win2019Srv | Win2022Std | Win2022Dtc | Win2022DtcAzure | Win2025Std | Win2025Dtc | Win2025DtcAzure}]
 [-LocationType {Default | OptedIn | EndpointUrl}]
 [-ManageRDPTransportProtocol {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [-NewName <string>]
 [-NewServer <string>] [-NutanixPCVersion {NutanixPC | v7_3 | v7_5}]
 [-NutanixVersion {Nutanix | v5_15 | v5_20 | v6_5 | v6_10 | v7_3}] [-Port <uint>]
 [-PreferredConnectionBrokerId <uint>] [-PreferredConnectionBrokerObj <ConnectionBroker>]
 [-PrinterNameFormat {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}]
 [-ProviderPassword <SecureString>] [-ProviderUsername <string>] [-RegionCode <string>]
 [-RegionName <string>] [-RemotePCDynamicSubnet <string>] [-RemoveClientNameFromPrinterName <bool>]
 [-RemoveSessionNumberFromPrinterName <bool>] [-ResourcePool <string>] [-ResourcePoolID <string>]
 [-ScaleVersion {Scale | v9_4 | v9_6}] [-SecretAccessKey <SecureString>] [-StartMacAddress <string>]
 [-SupportShellURLNamespaceObjects <bool>] [-UseAllGuests <bool>] [-UseSameAppRegAsProvider <bool>]
 [-VCenterVersion {VmwareVCenter | v6_5 | v6_7 | v7_0 | v8_0 | v9_0 | v9_1}] [-VDIAgent <string>]
 [-VDIPort <uint>] [-VmwareESXiVersion {VmwareESXi | v6_5 | v6_7 | v7_0 | v8_0 | v9_0 | v9_1}]
 [-WebAccessURL <string>] [-Workdir <string>] [<CommonParameters>]
```

## DESCRIPTION

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.

## EXAMPLES

### Example 1

```powershell
Set-RASProvider -Server "server.company.dom" -Enabled $False
```

Disables the specified Provider server in the Licensing Server site.

### Example 2

```powershell
Set-RASProvider -Id 3 -Enabled $False
```

Disables the Provider server specified by ID.

### Example 3

```powershell
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

```powershell
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

```powershell
Get-RASProvider -Id 3 | Set-RASProvider -Enabled $True
```

Enables the Provider server represented by a Provider object obtained from the pipeline output.

## PARAMETERS

### -Name

The name of the Provider.

```yaml
Type: string
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SiteId

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.

```yaml
Type: uint
Required: False
Position: 1
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -Id

The ID of the Provider server to modify. To obtain the ID, use the Get-RASProvider cmdlet.

```yaml
Type: uint
Required: True
Position: 0
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -InputObject

An object representing the Provider server to modify.

To obtain the object, use the Get-RASProvider cmdlet.

Type reference: [Provider](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/provider.md)

```yaml
Type: Provider
Required: True
Position: 0
Default value: None
Accept pipeline input: true (ByValue)
Accept wildcard characters: False
```

### -Enabled

Enables or disables the specified Provider server in a site.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NewName

A new name for the Provider.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NewServer

The name of the target Provider server.

This must be the actual server name used in the RAS farm.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Description

A user-defined Provider server description.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DirectAddress

Specifies the Provider server direct address.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Port

Specifies the port number for the RAS VDI Agent.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -VDIAgent

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.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowURLAndMailRedirection

Set the URL and Mail Redirection option. Possible values: 0 = Disabled, 1 = Enabled, 2 = Enabled with application registration.

Possible values: Disabled, Enabled, EnabledWithAppRegistration

Type reference: [AllowURLAndMailRedirection](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/allowurlandmailredirection.md)

```yaml
Type: AllowURLAndMailRedirection
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SupportShellURLNamespaceObjects

Enable or disable the 'Support Shell URL Namespace Objects' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowDragAndDrop

Set the Drag and Drop option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -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

Type reference: [FileTransferControlMode](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/filetransfercontrolmode.md)

```yaml
Type: FileTransferControlMode
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FileTransferLocation

Location where the File Transfer takes place, if and where it is allowed.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FileTransferLockLocation

Lock Location where the File Transfer takes place, if and where it is allowed.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FileTransferSuppressPromptForUploadFiles

Specifies if the 'Suppress prompt for upload files' option is enabled or disabled.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FileTransferExistingFileMode

Specifies the behavior when a file with the same name already exists in the destination folder during file transfer.

Possible values: CreateNewFile, OverwriteExistingFile

Type reference: [FileTransferExistingFileMode](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/filetransferexistingfilemode.md)

```yaml
Type: FileTransferExistingFileMode
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FileTransferAutoCloseWindow

Specifies if the "Close transfer window when complete" option is enabled or disabled.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RemoveClientNameFromPrinterName

Enable or disable the 'Remove client name from printer name' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RemoveSessionNumberFromPrinterName

Enable or disable the 'Remove session number from printer name' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PrinterNameFormat

Specifies the 'RDP Printer Name Format' option.

Possible values: PrnFormat\_PRN\_CMP\_SES, PrnFormat\_SES\_CMP\_PRN, PrnFormat\_PRN\_REDSES

Type reference: [PrnNameFormat](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/prnnameformat.md)

```yaml
Type: PrnNameFormat
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AutoPreferredConnectionBroker

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.

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

### -EnableDriveRedirectionCache

Enable or disable the 'Enable Drive Redirection Cache' option.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DriveRedirectionFileCache

Specifies the 'File Cache' mode to be used with drive redirection.

Possible values: None, ReadAhead, ReadAheadWriteBehind

Type reference: [DriveRedirectionFileCacheMode](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/driveredirectionfilecachemode.md)

```yaml
Type: DriveRedirectionFileCacheMode
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ManageRDPTransportProtocol

Manage RDP transport protocol.

Possible values: Disabled, BothUDPTCP, OnlyTCP, EitherUDPTCP

Type reference: [ManageRDPTransportProtocol](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/managerdptransportprotocol.md)

```yaml
Type: ManageRDPTransportProtocol
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ProviderUsername

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.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ProviderPassword

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.

```yaml
Type: SecureString
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -VDIPort

The port to communicate with the dedicated VDIAgent specified in the VDIAgent parameter.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PreferredConnectionBrokerObj

The preferred Connection Broker server.

To obtain an object of type Broker representing the preferred Connection Broker, use the Get-RASConnectionBroker cmdlet.

Type reference: [ConnectionBroker](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/connectionbroker.md)

```yaml
Type: ConnectionBroker
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PreferredConnectionBrokerId

The preferred Connection Broker ID.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseAllGuests

Use all guests.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CostOptimizeTimeout

Cost Optimize Timeout in seconds. Applicable to: AVD and Azure.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableCostOptimize

Enable Cost Optimize. Applicable to: AVD and Azure.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CollectCostsForThisProvider

Collect costs for this provider.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseSameAppRegAsProvider

Use the same application registration configured on this provider.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CostInsightsAppID

Cost Insights Application ID credential.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -CostInsightsAppKey

The password of the account specified in the CostInsightsAppID parameter.

```yaml
Type: SecureString
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FeedURL

The Feed URL. Applicable to: AVD.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WebAccessURL

The Web Access URL. Applicable to: AVD.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ADType

The ADType. Applicable to: AVD.

Possible values: ActiveDirectoryDomainServicesObjectGuid, ActiveDirectoryDomainServicesObjectGuidString, MicrosoftEntraDomainServices, WindowsServerADDS, AzureADDS

Type reference: [ADType](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/adtype.md)

```yaml
Type: ADType
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AccessKeyID

The access key ID of the Amazon Web Service account. Applicable to: AWSEC2.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SecretAccessKey

The secret access key of the Amazon Web Service account. Applicable to: AWSEC2.

```yaml
Type: SecureString
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -LocationType

The location type of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.

Possible values: Default, OptedIn, EndpointUrl

Type reference: [EC2LocationType](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/ec2locationtype.md)

```yaml
Type: EC2LocationType
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RegionName

The region name of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RegionCode

The region code of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EndpointUrl

The endpoint URL of the Amazon Elastic Compute Cloud. Applicable to: AWSEC2.

Example: <https://ec2.us-east01.amazonaws.com>.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Arguments

Arguments to launch the script. Applicable to: Custom Provider.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Command

Command to launch the script. Applicable to: Custom Provider.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Workdir

Script working directory. Applicable to: Custom Provider.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HyperVVersion

Specifies the HyperV Version. Applicable to: HyperV.

Possible values: HyperV, Win2012R2Std, Win2012R2Dtc, Win2012R2Srv, Win2016Std, Win2016Dtc, Win2016Srv, Win2019Std, Win2019Dtc, Win2019Srv, Win2022Std, Win2022Dtc, Win2022DtcAzure, Win2025Std, Win2025Dtc, Win2025DtcAzure

Type reference: [HyperVVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/hypervversion.md)

```yaml
Type: HyperVVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HyperVFailoverVersion

Specifies the HyperV Failover Version. Applicable to: HyperV Failover.

Possible values: HyperVFailoverCluster, Ent, Dtc, Win2012, Win2012R2, Win2016, Win2019, Win2022, Win2025

Type reference: [HyperVFailoverClusterVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/hypervfailoverclusterversion.md)

```yaml
Type: HyperVFailoverClusterVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -StartMacAddress

Starting MAC Address. Applicable to: HyperV Failover.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EndMacAddress

Ending MAC Address. Applicable to: HyperV Failover.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableMacManagement

Specifies if the MAC Management is enabled or not. Applicable to: HyperV Failover.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NutanixVersion

Specifies the Nutanix Version. Applicable to: Nutanix.

Possible values: Nutanix, v5\_15, v5\_20, v6\_5, v6\_10, v7\_3

Type reference: [NutanixVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/nutanixversion.md)

```yaml
Type: NutanixVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -NutanixPCVersion

Specifies the Nutanix Prism Central Version. Applicable to: NutanixPC

Possible values: NutanixPC, v7\_3, v7\_5

Type reference: [NutanixPCVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/nutanixpcversion.md)

```yaml
Type: NutanixPCVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DomainTargetOU

Domain Target OU. Applicable to: Remote PC Dynamic.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RemotePCDynamicSubnet

The subnet of the remote PC dynamic. Applicable to: Remote PC Dynamic.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ScaleVersion

Specifies the Scale Version. Applicable to: Scale.

Possible values: Scale, v9\_4, v9\_6

Type reference: [ScaleVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/scaleversion.md)

```yaml
Type: ScaleVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -VCenterVersion

Specifies the VCenter Version. Applicable to: VCenter.

Possible values: VmwareVCenter, v6\_5, v6\_7, v7\_0, v8\_0, v9\_0, v9\_1

Type reference: [VmwareVCenterVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/vmwarevcenterversion.md)

```yaml
Type: VmwareVCenterVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ResourcePool

Resource Pool. Applicable to: VCenter

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ResourcePoolID

Resource Pool ID. Applicable to: VCenter

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -VmwareESXiVersion

Specifies the VMware ESXi Version. Applicable to: VMwareESXi

Possible values: VmwareESXi, v6\_5, v6\_7, v7\_0, v8\_0, v9\_0, v9\_1

Type reference: [VmwareESXiVersion](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/vmwareesxiversion.md)

```yaml
Type: VmwareESXiVersion
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### 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](https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### [Provider](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/provider.md)

## OUTPUTS

### None

## RELATED LINKS

* [New-RASProvider](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/new-rasprovider.md)
* [Get-RASProvider](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rasprovider.md)
* [Remove-RASProvider](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/remove-rasprovider.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-rasprovider.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
