Parallels Remote Application Server Requirements

Parallels RAS PowerShell requires 'Connection Broker' component of a matching version to communicate with.

Microsoft Windows Component Requirements

The following components must be installed on the computer where you'll be executing Parallels RAS PowerShell cmdlets:

• Windows PowerShell 3.0 or higher

• Microsoft .NET Framework 4.5.2 or higher

Basic Concepts

To get started with Parallels RAS PowerShell, complete thefollowing steps:

1. Open the Windows PowerShell console.

2. In the console, type the following command to import the Parallels RAS PowerShell module:

   Import-Module RASAdmin

3. Create a Parallels RAS session by executing the New-RASSession cmdlet. Substitute the server name (in quotes) with the name or IP address of your Parallels RAS Licensing Server. Type your RAS administrator username and password when prompted.

   New-RASSession -Server "server.company.dom"

4. Execute the following cmdlet to see the list of cmdlets included in the Parallels RAS PowerShell module:

   Get-Command -Module RASAdmin

5. Execute other cmdlets. For example, try executing the Get-RASGateway cmdlet to retrieve information about RAS Secure Gateway(s). The example below returns information about all RAS Secure Gateways available in the RAS Licensing Server site:

   Get-RASGateway

6. To see help for a cmdlet, execute Get-Help passing a cmdlet name:

   Get-Help Get-RASGateway

   To apply changes you've made to the farm configuration, use the Invoke-RASApply cmdlet:

   Invoke-RASApply

   To activate a Parallels RAS license, use Invoke-RASLicenseActivate:

   Invoke-RASLicenseActivate

   When executing the cmdlet above, you'll be prompted to enter your Parallels My Account email address and password. Passing a license key (the -Key parameter) is optional. If omitted (as in the example above), Parallels RAS is activated as a trial.

© 2024 Parallels International GmbH. Parallels and the Parallels logo are trademarks or registered trademarks of Parallels International GmbH in Canada, the U.S., and/or elsewhere.

NAME

Add-RASAppPackageAssigned

SYNOPSIS

Assigns an application package to an object type.

SYNTAX

Add-RASAppPackageAssigned -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -PackageName <string> -Version <string> [-SiteId <uint>] [<CommonParameters>]

Add-RASAppPackageAssigned [-Id] <uint> -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -PackageName <string> -Version <string> [<CommonParameters>]

Add-RASAppPackageAssigned [-InputObject] <RASSerilazableObj> -PackageName <string> -Version <string> [<CommonParameters>]

Add-RASAppPackageAssigned [-Name] <string> [[-SiteId] <uint>] -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -PackageName <string> -Version <string> [<CommonParameters>]

DESCRIPTION

Adds assigned application package to an object type.

PARAMETERS

-Name <string> The name for which to modify the application package assigned settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID from which to modify the application package assigned settings.

If the parameter is omitted, the Licensing Server site ID will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID for which to modify the Application Package assigned settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <AppPackageAssignedObjType> The Object Type for which to modify the assigned application package settings.

Possible values: RDSHost, RDS, RDSHostPool, RDSGroup, VDIHostPool, VDIPool, AVDHostPool

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <ServerDefObjType> The Default Object Type for which to modify the application package settings.

Possible values: RDSDef, VDIDef, AVDSingleSessionDefaultSettings, AVDMultiSessionDefaultSettings, VDIGuestDef

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASSerilazableObj> An object of type RDS, RDSHostPool or VDIHostPool for which to modify the Assigned Application settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-PackageName <string> The application package name.

This must be the actual application package name used in the RAS farm.

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Version <string> The version of the application package.

This must be the actual application package version used in the RAS farm.

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASAppPackageAssigned -Id 3 -ObjType VDIPool -PackageName Mozilla.MozillaFireFox -Version 99.0.0.0

Adds the assigned application package to the object type VDIPool.

RELATED LINKS

• Remove-RASAppPackageAssigned

• Get-RASAppPackageAssigned

• Set-RASAppPackageAssigned

• Invoke-RASAppPackageAssigned

NAME

Add-RASClientPolicyConnection

SYNOPSIS

Adds a new connection to the Connection List.

SYNTAX

Add-RASClientPolicyConnection [-Id] <uint> -Mode {GatewayMode | GatewaySSLMode | DirectMode | DirectSSLMode} -Server <string> -ServerPort <uint> [<CommonParameters>]

Add-RASClientPolicyConnection [-InputObject] <ClientRules> -Mode {GatewayMode | GatewaySSLMode | DirectMode | DirectSSLMode} -Server <string> -ServerPort <uint> [<CommonParameters>]

Add-RASClientPolicyConnection [-Name] <string> -Mode {GatewayMode | GatewaySSLMode | DirectMode | DirectSSLMode} -Server <string> -ServerPort <uint> [<CommonParameters>]

DESCRIPTION

Adds a new connection to the Connection List

PARAMETERS

-Mode <Mode> The mode type of connection.

Possible values: GatewayMode, GatewaySSLMode, DirectMode, DirectSSLMode

        Required?                    true

        Position?                    named

        Default value                GatewayMode

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Server <string> The Server which the user is going to connect to.

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ServerPort <uint> The port of the Server.

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Name <string> Name of the client policy to modify.

This must be the actual client policy name used in the RAS farm.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID of the client policy to modify. To obtain the ID, use the Get-RASClientPolicy cmdlet.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <ClientRules> The client policy object to modify.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

ClientRules

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASClientPolicyConnection -Id 1 -Mode "Gateway Mode" -Server "xyz" -ServerPort "80"

Adds the client policy connection with the following settings with Id=1.

RELATED LINKS

• Set-RASClientPolicy

• Get-RASClientPolicy

• Get-RASClientPolicyConnection

• Remove-RASClientPolicyConnection

NAME

Add-RASCriteriaDevice

SYNOPSIS

Adds a Client Device to the Criteria Device List.

SYNTAX

Add-RASCriteriaDevice [-] {MFA} [[-] <uint>] - <string> [<>]

Add-RASCriteriaDevice [-] <uint> - <string> - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [<>]

Add-RASCriteriaDevice [-] <> - <string> [- <uint>] [<>]

Add-RASCriteriaDevice [-] <string> [[-] <uint>] - <string> - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [<>]

DESCRIPTION

Adds a Client Device to the Criteria Device List within the Criteria settings of a ClientPolicy, MFA or PubItem.

PARAMETERS

-ClientDeviceName <string> The name of the client device to add to the Criteria.

-Name <string> The name or server for which to modify the Criteria settings.

-SiteId <uint> Site ID for which to modify the Criteria settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

Possible values: MFA

-RuleId <uint> The ID of the Rule to modify.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASCriteriaDevice -Id 1 -ObjType LogonHours -ClientDeviceName "Device1"

Adds the Device specified by Name to the Criteria Device List within the Criteria Settings of the specified Logon Hours by ID. ---------- EXAMPLE 2 ----------

Add-RASCriteriaDevice -Name "Logon1" -ObjType LogonHours -ClientDeviceName "Device1"

Adds the Device specified by Name to the Criteria Device List within the Criteria Settings of the specified Logon Hours by Name.

RELATED LINKS

NAME

Add-RASCriteriaGatewayIP

SYNOPSIS

Adds a Gateway IP to the Criteria Gateway List.

SYNTAX

Add-RASCriteriaGatewayIP [-] {MFA} [[-] <uint>] [- <uint>] [- <string>] [<>]

Add-RASCriteriaGatewayIP [-] <uint> - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [- <string>] [- <uint>] [<>]

Add-RASCriteriaGatewayIP [-] <> [- <uint>] [- <string>] [- <uint>] [<>]

Add-RASCriteriaGatewayIP [-] <string> [[-] <uint>] - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [- <string>] [- <uint>] [<>]

DESCRIPTION

Adds a Gateway IP to the Criteria Gateway List within the Criteria settings of a ClientPolicy, MFA or PubItem.

PARAMETERS

-IP <string> The IP of the gateway to add to the Criteria.

-GatewayId <uint> The ID of the gateway to add to the Criteria.

-Name <string> The name or server for which to modify the Criteria settings.

-SiteId <uint> Site ID for which to modify the Criteria settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

Possible values: MFA

-RuleId <uint> The ID of the Rule to modify.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASCriteriaGatewayIP -Id 1 -ObjType MFA -IP "1.2.3.4"

Adds the specified Gateway IP to the Criteria Gateway List within the Criteria Settings of the specified MFA by ID. ---------- EXAMPLE 2 ----------

Add-RASCriteriaGatewayIP -Name "Logon1" -ObjType MFA -GatewayId 1

Adds the IP from the Gateway with specified ID to the Criteria Gateway List within the Criteria Settings of the specified MFA by Name.

RELATED LINKS

NAME

Add-RASAVDHostPoolAssignment

SYNOPSIS

Adds a user or group to the Azure Virtual Desktop Host Pool Assignment List.

SYNTAX

Add-RASAVDHostPoolAssignment [-] <uint> [- <string>] [- <string>] [<>]

Add-RASAVDHostPoolAssignment [-] <> [- <string>] [- <string>] [<>]

Add-RASAVDHostPoolAssignment [-] <string> [[-] <uint>] [- <string>] [- <string>] [<>]

DESCRIPTION

Adds a user or group to the Azure Virtual Desktop Host Pool Assignment List within an Azure Virtual Desktop Host Pool.

PARAMETERS

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

-Account <string> The name of the account to add to the Assignments.

-SID <string> The SID of the account to add to the Assignments.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASAVDHostPoolAssignment -Id 1 -Account "JaneDoe"

Adds a user to the AVD Host Pool Assignment List within the AVD Host Pool Settings specified by Id. ---------- EXAMPLE 2 ----------

Add-RASAVDHostPoolAssignment -Name "Logon1" -Account "SID://DOMAIN/JaneDoe"

Adds a user to the AVD Host Pool Assignment List within the AVD Host Pool Settings specified by Name.

RELATED LINKS

NAME

Add-RASCriteriaHardwareID

SYNOPSIS

Adds a Hardware ID to the Criteria Hardware ID List.

SYNTAX

Add-RASCriteriaHardwareID [-] {MFA} [[-] <uint>] - <string> [<>]

Add-RASCriteriaHardwareID [-] <uint> - <string> - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [<>]

Add-RASCriteriaHardwareID [-] <> - <string> [- <uint>] [<>]

Add-RASCriteriaHardwareID [-] <string> [[-] <uint>] - <string> - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [<>]

DESCRIPTION

Adds a Hardware ID to the Criteria Hardware ID List within the Criteria settings of a ClientPolicy, MFA or PubItem.

PARAMETERS

-HardwareID <string> The hardware ID to add to the Criteria.

-Name <string> The name or server for which to modify the Criteria settings.

-SiteId <uint> Site ID for which to modify the Criteria settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

Possible values: MFA

-RuleId <uint> The ID of the Rule to modify.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASCriteriaHardwareID -Id 1 -ObjType MFA -HardwareID "D4-3D-7E-BF-4B-DC"

Adds the specified Hardware ID to the Criteria Hardware ID List within the Criteria Settings of the specified MFA by ID. ---------- EXAMPLE 2 ----------

Add-RASCriteriaHardwareID -Name "Logon1" -ObjType MFA -HardwareID "D4-3D-7E-BF-4B-DC"

Adds the specified Hardware ID to the Criteria Hardware ID List within the Criteria Settings of the specified MFA by Name.

RELATED LINKS

NAME

Add-RASAutoUpgradeMessage

SYNOPSIS

Adds schedule message information within Auto-upgrade settings.

SYNTAX

Add-RASAutoUpgradeMessage - {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} - <string> - <string> [- <bool>] [- <uint>] [- {Before | After}] [- <uint>] [<>]

Add-RASAutoUpgradeMessage [-] <uint> - <string> - <string> - {RDSHostPool | VDIHostPool | AVDHostPool} [- <bool>] [- <uint>] [- {Before | After}] [<>]

Add-RASAutoUpgradeMessage [-] <> - <string> - <string> [- <bool>] [- <uint>] [- {Before | After}] [<>]

Add-RASAutoUpgradeMessage [-] <string> [[-] <uint>] - <string> - <string> - {RDSHostPool | VDIHostPool | AVDHostPool} [- <bool>] [- <uint>] [- {Before | After}] [<>]

DESCRIPTION

Adds schedule message information within Auto-upgrade settings.

PARAMETERS

-Enabled <bool> Whether to enable or disable the message.

-MessageTitle <string> The title of the message.

-Message <string> A message that should be sent to users before the job starts.

-SendMsgSecs <uint> Time interval in seconds before the job starts when the message to users should be sent.

Send Message When can only be set to After in the case of Reboot.

Possible values: Before, After

-Name <string> The name or server for which to modify the Auto-upgrade settings.

-SiteId <uint> Site ID from which to modify the Auto-upgrade settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Auto-upgrade settings.

Possible values: RDSHostPool, VDIHostPool, AVDHostPool

Possible values: RDSDef, VDIDef, AVDSingleSessionDefaultSettings, AVDMultiSessionDefaultSettings, VDIGuestDef

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASAutoUpgradeMessage -DefObjType RDSDef -Enabled 0 -SendMsgSecs 60 -SendMsgWhen Before -MessageTitle "messageTitle" -Message "messageBody"

Adds a message to the Auto-upgrade settings of the RDS Default Settings. ---------- EXAMPLE 2 ----------

Add-RASAutoUpgradeMessage -Name "VDIHostPool1" -ObjType VDIHostPool -Enabled 0 -SendMsgSecs 60 -SendMsgWhen Before -MessageTitle "messageTitle" -Message "messageBody"

Adds a message to the Auto-upgrade settings of the specified VDIHostPool by Name. ---------- EXAMPLE 3 ----------

Add-RASAutoUpgradeMessage -Id 1 -ObjType AVDHostPool -Enabled 0 -SendMsgSecs 60 -SendMsgWhen Before -MessageTitle "messageTitle" -Message "messageBody"

Adds a message to the Auto-upgrade settings of the specified AVDHostPool by Id.

RELATED LINKS

NAME

Add-RASCriteriaTheme

SYNOPSIS

Adds a Theme to the Criteria Theme List.

SYNTAX

Add-RASCriteriaTheme [-] {MFA} [[-] <uint>] [- <uint>] [- <string>] [<>]

Add-RASCriteriaTheme [-] <uint> - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [- <uint>] [- <string>] [<>]

Add-RASCriteriaTheme [-] <> [- <uint>] [- <uint>] [- <string>] [<>]

Add-RASCriteriaTheme [-] <string> [[-] <uint>] - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [- <uint>] [- <string>] [<>]

DESCRIPTION

Adds a Theme to the Criteria Theme List within the Criteria settings of a ClientPolicy, MFA or PubItem.

PARAMETERS

-ThemeName <string> The name of the theme to add to the Criteria.

-ThemeId <uint> The ID of the theme to add to the Criteria.

-Name <string> The name or server for which to modify the Criteria settings.

-SiteId <uint> Site ID for which to modify the Criteria settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

Possible values: MFA

-RuleId <uint> The ID of the Rule to modify.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASCriteriaTheme -Id 1 -ObjType LogonHours -ThemeName "Theme1"

Adds the Theme specified by Name to the Criteria Theme List within the Criteria Settings of the specified Logon Hours by ID. ---------- EXAMPLE 2 ----------

Add-RASCriteriaTheme -Name "Logon1" -ObjType LogonHours -ThemeId 1

Adds the Theme specified by ID to the Criteria Theme List within the Criteria Settings of the specified Logon Hours by Name.

RELATED LINKS

NAME

Add-RASCriteriaSecurityPrincipal

SYNOPSIS

Adds a user, group or machine to the Criteria Security Principal List.

SYNTAX

Add-RASCriteriaSecurityPrincipal [-] {MFA} [[-] <uint>] [- <string>] [- <string>] [<>]

Add-RASCriteriaSecurityPrincipal [-] <uint> - {ClientPolicy | PubItem | MFA | LogonHours} [- <string>] [- <uint>] [- <string>] [<>]

Add-RASCriteriaSecurityPrincipal [-] <> [- <string>] [- <uint>] [- <string>] [<>]

Add-RASCriteriaSecurityPrincipal [-] <string> [[-] <uint>] - {ClientPolicy | PubItem | MFA | LogonHours} [- <string>] [- <uint>] [- <string>] [<>]

DESCRIPTION

Adds a user, group or machine to the Criteria Security Principal List within the Criteria settings of a ClientPolicy, MFA or PubItem.

PARAMETERS

-Account <string> The name of the account to add to the Criteria.

-SID <string> The SID of the account to add to the Criteria.

-Name <string> The name or server for which to modify the Criteria settings.

-SiteId <uint> Site ID for which to modify the Criteria settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

Possible values: MFA

-RuleId <uint> The ID of the Rule to modify.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASCriteriaSecurityPrincipal -Id 1 -ObjType MFA -Account "JaneDoe"

Adds a user to the Criteria Security Principal List within the Criteria Settings of the specified MFA by ID. ---------- EXAMPLE 2 ----------

Add-RASCriteriaSecurityPrincipal -Name "Logon1" -ObjType MFA -Account "SID://DOMAIN/JaneDoe"

Adds a user to the Criteria Security Principal List within the Criteria Settings of the specified MFA by Name.

RELATED LINKS

This guide contains information about Parallels RAS PowerShell. It is intended for Parallels RAS administrators who would like to use PowerShell to automate their RAS administration tasks.

Organization of This Guide

The guide is organized into the following main sections:

lists system requirements and explains basic RAS PowerShell concepts.

is a complete reference to RAS PowerShell cmdlets.

lists available API versions and changes between them.

includes cmdlet examples demonstrating how to perform the most common Parallels RAS management tasks.

Additional Resources

For additional Parallels RAS documentation and resources, please visit

© 2024 Parallels International GmbH. Parallels and the Parallels logo are trademarks or registered trademarks of Parallels International GmbH in Canada, the U.S., and/or elsewhere.

NAME

Add-RASCriteriaIP

SYNOPSIS

Adds an IP to the Criteria IP List.

SYNTAX

Add-RASCriteriaIP [-] {MFA} [[-] <uint>] - <string> - {Version4 | Version6 | BothVersions} [<>]

Add-RASCriteriaIP [-] <uint> - <string> - {Version4 | Version6 | BothVersions} - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [<>]

Add-RASCriteriaIP [-] <> - <string> - {Version4 | Version6 | BothVersions} [- <uint>] [<>]

Add-RASCriteriaIP [-] <string> [[-] <uint>] - <string> - {Version4 | Version6 | BothVersions} - {ClientPolicy | PubItem | MFA | LogonHours} [- <uint>] [<>]

DESCRIPTION

Adds an IP to the Criteria IP List within the Criteria settings of a ClientPolicy, MFA or PubItem.

PARAMETERS

-IP <string> Value that represents the IP

Possible values: Version4, Version6, BothVersions

-Name <string> The name or server for which to modify the Criteria settings.

-SiteId <uint> Site ID for which to modify the Criteria settings.

If the parameter is omitted, the Licensing Server site ID will be used.

-Id <uint> The ID of a server for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

Possible values: MFA

-RuleId <uint> The ID of the Rule to modify.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASCriteriaIP -Id 1 -ObjType MFA -IP "1.2.3.4" -IPType Version4

Adds the specified IPv4 to the Criteria IP List within the Criteria Settings of the specified MFA by ID. ---------- EXAMPLE 2 ----------

Add-RASCriteriaIP -Name "Logon1" -ObjType MFA -IP "1.2.3.4-1.2.3.5" -IPType Version4

Adds the IPv4 Range to the Criteria IP List within the Criteria Settings of the specified MFA by Name.

RELATED LINKS

NAME

Add-RASExcludeADGroup

SYNOPSIS

Adds an Exclude AD group entry.

SYNTAX

Add-RASExcludeADGroup [- <string>] [- <string>] [- <uint>] [<>]

DESCRIPTION

Adds an Exclude AD group to the Exclude AD group settings list.

PARAMETERS

-Account <string> The name of the group account to add to the Exclude AD group list.

-SID <string> The SID of the group account to add to the Exclude AD group list.

-SiteId <uint> Site ID in which to modify the specified Exclude AD group settings.

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASExcludeADGroup -Account Guests

Adds an Exclude AD group to the Exclude AD group settings list for the current site.

RELATED LINKS

NAME

Add-RASHALBDevice

SYNOPSIS

Add a new HALB Device to the specific HALB Virtual Server instance.

SYNTAX

Add-RASHALBDevice [[-] <uint>] [-] <string> [[-] <SwitchParameter>] [<>]

Add-RASHALBDevice [-] <> [-] <string> [[-] <SwitchParameter>] [<>]

Add-RASHALBDevice [-] <string> [[-] <uint>] [-] <string> [[-] <SwitchParameter>] [<>]

DESCRIPTION

Add a new HALB Device to the specific HALB Virtual Server instance.

PARAMETERS

-HALBName <string>

-SiteId <uint>

-HALBId <uint>

-DeviceIP <string>

-NoInstall <SwitchParameter>

The object is obtained using the Get-RASHALB cmdlet.

<CommonParameters>

INPUTS

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASHALBDevice -HALBId 1 -DeviceIP "1.2.3.4"

Adds the HALB Device to a specific HALB Virtual Server instance by id. ---------- EXAMPLE 2 ----------

Add-RASHALBDevice -HALBName "HALB-VS" -SiteId 1 -DeviceIP "1.2.3.4"

Adds the HALB Device to a specific HALB Virtual Server instance by name.

RELATED LINKS

NAME

Add-RASFSLogixUser

SYNOPSIS

Adds a user to an Inclusion/Exclusion List of the Profile Container.

SYNTAX

Add-RASFSLogixUser -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -GeneralSettings <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [-SiteId <uint>] [<CommonParameters>]

Add-RASFSLogixUser -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -OfficeContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [-SiteId <uint>] [<CommonParameters>]

Add-RASFSLogixUser -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -ProfileContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [-SiteId <uint>] [<CommonParameters>]

Add-RASFSLogixUser [-Id] <uint> -GeneralSettings <SwitchParameter> -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-Id] <uint> -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -OfficeContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-Id] <uint> -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -ProfileContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-InputObject] <RASSerilazableObj> -GeneralSettings <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-InputObject] <RASSerilazableObj> -OfficeContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-InputObject] <RASSerilazableObj> -ProfileContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-Name] <string> [[-SiteId] <uint>] -GeneralSettings <SwitchParameter> -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-Name] <string> [[-SiteId] <uint>] -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -OfficeContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASFSLogixUser [-Name] <string> [[-SiteId] <uint>] -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -ProfileContainer <SwitchParameter> -UserListType {Inclusion | Exclusion} [-Account <string>] [-SID <string>] [<CommonParameters>]

DESCRIPTION

Adds a user to an Inclusion/Exclusion List of the Profile Container within the FSLogix settings of RDSH, RDSHostPool, RDSDefaults, VDIDesktop, VDITemplate or VDIDesktopDefaults

PARAMETERS

-UserListType <FSLogixListType> Specifies the 'User List Type'.

Possible values: Inclusion, Exclusion

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Account <string> The name of the user/group account to add to the FSLogix Container.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SID <string> The SID of the user/group account to add to the FSLogix Container.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Name <string> The name or server for which to modify the FSLogix settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID from which to modify the FSLogix settings.

If the parameter is omitted, the Licensing Server site ID will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID of a server for which to modify the FSLogix settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASSerilazableObj> An object of type RDS, RDSHostPool, VDITemplate or VDIDesktop for which to modify the FSLogix settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <FSLogixServerObjType> The Object Type for which to modify the FSLogix settings.

Possible values: RDSHost, RDS, RDSHostPool, RDSGroup, VDIHostPool, VDIPool, AVDHostPool

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <ServerDefObjType> The Default Object Type for which to modify the FSLogix settings.

Possible values: RDSDef, VDIDef, AVDSingleSessionDefaultSettings, AVDMultiSessionDefaultSettings, VDIGuestDef

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ProfileContainer <SwitchParameter> Set the Profile Container settings.

        Required?                    true

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

-OfficeContainer <SwitchParameter> Sets the Office Container settings.

        Required?                    true

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

-GeneralSettings <SwitchParameter> Sets the General settings.

        Required?                    true

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASFSLogixUser -DefObjType RDSDef -ContainerType Profile -UserListType Inclusion -Account "JaneDoe"

Adds a user to the Inclusion List of the Profile Container within the FSLogix Settings of the RDS Default Settings. ---------- EXAMPLE 2 ----------

Add-RASFSLogixUser -Name "RDSHostPool1" -ObjType RDSHostPool -ContainerType Profile -UserListType Exclusion -Account "SID://DOMAIN/JaneDoe"

Adds a user to the Exclusion List of the Profile Container within the FSLogix Settings of the specified RDSHostPool by Name.

RELATED LINKS

• Get-RASFSLogix

• Set-RASFSLogix

• Get-RASFSLogixUser

• Remove-RASFSLogixUser

NAME

Add-RASFSLogixFolder

SYNOPSIS

Adds a folder to an Inclusion/Exclusion List of the Profile Container.

SYNTAX

Add-RASFSLogixFolder -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -Folder <string> -FolderListType {Inclusion | Exclusion} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [-SiteId <uint>] [<CommonParameters>]

Add-RASFSLogixFolder -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -Folder <string> -FolderListType {Inclusion | Exclusion} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [-SiteId <uint>] [<CommonParameters>]

Add-RASFSLogixFolder -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -Folder <string> -FolderListType {Inclusion | Exclusion} -ProfileContainer <SwitchParameter> [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [-SiteId <uint>] [<CommonParameters>]

Add-RASFSLogixFolder [-Id] <uint> -Folder <string> -FolderListType {Inclusion | Exclusion} -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-Id] <uint> -Folder <string> -FolderListType {Inclusion | Exclusion} -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-Id] <uint> -Folder <string> -FolderListType {Inclusion | Exclusion} -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -ProfileContainer <SwitchParameter> [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-InputObject] <RASSerilazableObj> -Folder <string> -FolderListType {Inclusion | Exclusion} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-InputObject] <RASSerilazableObj> -Folder <string> -FolderListType {Inclusion | Exclusion} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-InputObject] <RASSerilazableObj> -Folder <string> -FolderListType {Inclusion | Exclusion} -ProfileContainer <SwitchParameter> [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-Name] <string> [[-SiteId] <uint>] -Folder <string> -FolderListType {Inclusion | Exclusion} -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-Name] <string> [[-SiteId] <uint>] -Folder <string> -FolderListType {Inclusion | Exclusion} -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

Add-RASFSLogixFolder [-Name] <string> [[-SiteId] <uint>] -Folder <string> -FolderListType {Inclusion | Exclusion} -ObjType {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} -ProfileContainer <SwitchParameter> [-ExcludeFolderCopy {None | CopyBase | CopyBack}] [<CommonParameters>]

DESCRIPTION

Adds a folder to an Inclusion/Exclusion List of the Profile Container within the FSLogix settings of RDSH, RDSHostPool, RDSDefaults, VDIDesktop, VDITemplate or VDIDesktopDefaults.

PARAMETERS

-ExcludeFolderCopy <ExcludeFolderCopy> Specifies the 'Exclude Folder Copy', in case of adding to the Exclude Folder List.

Possible values: None, CopyBase, CopyBack

        Required?                    false

        Position?                    named

        Default value                CopyBase, CopyBack

        Accept pipeline input?       false

        Accept wildcard characters?  false

-FolderListType <FSLogixListType> Specifies the 'Folder List Type'.

Possible values: Inclusion, Exclusion

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Folder <string> Specifies the 'Folder' path to add to the Include/Exclude Folder List.

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Name <string> The name or server for which to modify the FSLogix settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID from which to modify the FSLogix settings.

If the parameter is omitted, the Licensing Server site ID will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID of a server for which to modify the FSLogix settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASSerilazableObj> An object of type RDS, RDSHostPool, VDITemplate or VDIDesktop for which to modify the FSLogix settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <FSLogixServerObjType> The Object Type for which to modify the FSLogix settings.

Possible values: RDSHost, RDS, RDSHostPool, RDSGroup, VDIHostPool, VDIPool, AVDHostPool

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <ServerDefObjType> The Default Object Type for which to modify the FSLogix settings.

Possible values: RDSDef, VDIDef, AVDSingleSessionDefaultSettings, AVDMultiSessionDefaultSettings, VDIGuestDef

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ProfileContainer <SwitchParameter> Set the Profile Container settings.

        Required?                    true

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASFSLogixFolder -DefObjType RDSDef -ContainerType Profile -FolderListType Inclusion -Folder "C:/Test1"

Adds a folder to the Inclusion List of the Profile Container within the FSLogix Settings of the RDS Default Settings. ---------- EXAMPLE 2 ----------

Add-RASFSLogixFolder -Name "RDSHostPool1" -ObjType RDSHostPool -ContainerType Profile -FolderListType Exclusion -Folder "C:/Test2"

Adds a folder to the Exclusion List of the Profile Container within the FSLogix Settings of the specified RDSHostPool by Name.

RELATED LINKS

• Get-RASFSLogix

• Set-RASFSLogix

• Get-RASFSLogixFolder

• Remove-RASFSLogixFolder

NAME

Add-RASImageOptimizationRegistry

SYNOPSIS

Adds Registry property to the list.

SYNTAX

Add-RASImageOptimizationRegistry -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -DisplayName <string> -Path <string> [-Action {Add | Modify | Delete}] [-DWORDValue <uint>] [-HiveType {HKEY_CURRENT_CONFIG | HKEY_USERS | HKEY_LOCAL_MACHINE | HKEY_CLASSES_ROOT}] [-RegistryName <string>] [-RegType {REG_SZ | REG_DWORD | REG_QWORD | REG_MULTI_SZ | REG_EXPAND_SZ}] [-SiteId <uint>] [-StringValue <string>] [<CommonParameters>]

Add-RASImageOptimizationRegistry [-Id] <uint> -DisplayName <string> -ObjType {RDSHost | RDS | VDIHostPool | AVDHostPool | RDSTemplate | VDITemplate | AVDTemplate} -Path <string> [-Action {Add | Modify | Delete}] [-DWORDValue <uint>] [-HiveType {HKEY_CURRENT_CONFIG | HKEY_USERS | HKEY_LOCAL_MACHINE | HKEY_CLASSES_ROOT}] [-RegistryName <string>] [-RegType {REG_SZ | REG_DWORD | REG_QWORD | REG_MULTI_SZ | REG_EXPAND_SZ}] [-StringValue <string>] [<CommonParameters>]

Add-RASImageOptimizationRegistry [-InputObject] <RASSerilazableObj> -DisplayName <string> -Path <string> [-Action {Add | Modify | Delete}] [-DWORDValue <uint>] [-HiveType {HKEY_CURRENT_CONFIG | HKEY_USERS | HKEY_LOCAL_MACHINE | HKEY_CLASSES_ROOT}] [-RegistryName <string>] [-RegType {REG_SZ | REG_DWORD | REG_QWORD | REG_MULTI_SZ | REG_EXPAND_SZ}] [-StringValue <string>] [<CommonParameters>]

Add-RASImageOptimizationRegistry [-Name] <string> [[-SiteId] <uint>] -DisplayName <string> -ObjType {RDSHost | RDS | VDIHostPool | AVDHostPool | RDSTemplate | VDITemplate | AVDTemplate} -Path <string> [-Action {Add | Modify | Delete}] [-DWORDValue <uint>] [-HiveType {HKEY_CURRENT_CONFIG | HKEY_USERS | HKEY_LOCAL_MACHINE | HKEY_CLASSES_ROOT}] [-RegistryName <string>] [-RegType {REG_SZ | REG_DWORD | REG_QWORD | REG_MULTI_SZ | REG_EXPAND_SZ}] [-StringValue <string>] [<CommonParameters>]

DESCRIPTION

Adds Registry to the following list.

PARAMETERS

-Action <ActionType>

Possible values: Add, Modify, Delete

        Required?                    false

        Position?                    named

        Default value                Add

        Accept pipeline input?       false

        Accept wildcard characters?  false

-RegistryName <string>

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DWORDValue <uint>

        Required?                    false

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DisplayName <string>

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-HiveType <HiveType>

Possible values: HKEY_CURRENT_CONFIG, HKEY_USERS, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT

        Required?                    false

        Position?                    named

        Default value                HKEY_CURRENT_CONFIG

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Path <string>

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-RegType <ValueType>

Possible values: REG_SZ, REG_DWORD, REG_QWORD, REG_MULTI_SZ, REG_EXPAND_SZ

        Required?                    false

        Position?                    named

        Default value                REG_SZ

        Accept pipeline input?       false

        Accept wildcard characters?  false

-StringValue <string>

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Name <string> The name or server for which to modify the Image Optimization settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID from which to modify the Image Optimization settings.

If the parameter is omitted, the Licensing Server site ID will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID of a server for which to modify the Image Optimization settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASSerilazableObj> An object of type RDS, VDITemplate or VDIDesktop for which to modify the Image Optimization settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <OptimizationServerObjType> The Object Type for which to modify the Image Optimization settings.

Possible values: RDSHost, RDS, VDIHostPool, AVDHostPool, RDSTemplate, VDITemplate, AVDTemplate

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <ServerDefObjType> The Default Object Type for which to modify the Image Optimization settings.

Possible values: RDSDef, VDIDef, AVDSingleSessionDefaultSettings, AVDMultiSessionDefaultSettings, VDIGuestDef

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASImageOptimizationRegistry -Id 30 -ObjType RDS -Action Add -RegistryName "Name" -DWORDValue 1 -DisplayName HKEY_test -HiveType HKEY_CURRENT_CONFIG -Path System\CurrentControlSet\Services\Disk -RegType REG_SZ

Adds the Image Optimization Registry of the Object Type 'RDS'.

RELATED LINKS

• Get-RASImageOptimizationRegistry

• Remove-RASImageOptimizationRegistry

Parallels RAS PowerShell - Getting Started

NAME

Add-RASImageOptimizationWindowsScheduledTask

SYNOPSIS

Adds Windows Schedule Task.

SYNTAX

Add-RASImageOptimizationWindowsScheduledTask -DefObjType {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} -Location <string> -Task <string> [-SiteId <uint>] [<CommonParameters>]

Add-RASImageOptimizationWindowsScheduledTask [-Id] <uint> -Location <string> -ObjType {RDSHost | RDS | VDIHostPool | AVDHostPool | RDSTemplate | VDITemplate | AVDTemplate} -Task <string> [<CommonParameters>]

Add-RASImageOptimizationWindowsScheduledTask [-InputObject] <RASSerilazableObj> -Location <string> -Task <string> [<CommonParameters>]

Add-RASImageOptimizationWindowsScheduledTask [-Name] <string> [[-SiteId] <uint>] -Location <string> -ObjType {RDSHost | RDS | VDIHostPool | AVDHostPool | RDSTemplate | VDITemplate | AVDTemplate} -Task <string> [<CommonParameters>]

DESCRIPTION

Adds Windows Schedule Task to the following list.

PARAMETERS

-Task <string>

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Location <string>

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Name <string> The name or server for which to modify the Image Optimization settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID from which to modify the Image Optimization settings.

If the parameter is omitted, the Licensing Server site ID will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID of a server for which to modify the Image Optimization settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASSerilazableObj> An object of type RDS, VDITemplate or VDIDesktop for which to modify the Image Optimization settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <OptimizationServerObjType> The Object Type for which to modify the Image Optimization settings.

Possible values: RDSHost, RDS, VDIHostPool, AVDHostPool, RDSTemplate, VDITemplate, AVDTemplate

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <ServerDefObjType> The Default Object Type for which to modify the Image Optimization settings.

Possible values: RDSDef, VDIDef, AVDSingleSessionDefaultSettings, AVDMultiSessionDefaultSettings, VDIGuestDef

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Add-RASImageOptimizationWindowsScheduledTask -Id 30 -ObjType RDS -Path System\CurrentControlSet\Services\Disk -Type Folder

Adds the Windows Schedule Task List to the object type RDS.

RELATED LINKS

• Remove-RASImageOptimizationWindowsScheduledTask

• Get-RASImageOptimizationWindowsScheduledTask

NAME

Add-RASMFARadiusAuto

SYNOPSIS

Adds automation settings to Radius provider settings.

SYNTAX

Add-RASMFARadiusAuto [-Id] <uint> -Command <string> -Title <string> [-ActionMessage <string>] [-Description <string>] [-Enabled <bool>] [-Image {Alert | Message | Email | Call | Chat | Flag}] [<CommonParameters>]

Add-RASMFARadiusAuto [-InputObject] <MFA> -Command <string> -Title <string> [-ActionMessage <string>] [-Description <string>] [-Enabled <bool>] [-Image {Alert | Message | Email | Call | Chat | Flag}] [<CommonParameters>]

Add-RASMFARadiusAuto [-Name] <string> [[-SiteId] <uint>] -Command <string> -Title <string> [-ActionMessage <string>] [-Description <string>] [-Enabled <bool>] [-Image {Alert | Message | Email | Call | Chat | Flag}] [<CommonParameters>]

DESCRIPTION

The cmdlet appends new attribute settings to existing ones. All parameters are mandatory.

PARAMETERS

-Command <string> RADIUS Automation command

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Enabled <bool> Whether the RADIUS Automation is enabled/disabled

        Required?                    false

        Position?                    named

        Default value                True

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Image <ImageType> RADIUS Automation image

Possible values: Alert, Message, Email, Call, Chat, Flag

        Required?                    false

        Position?                    named

        Default value                Alert

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Title <string> RADIUS Automation title

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ActionMessage <string> RADIUS Automation action message

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Description <string> RADIUS Automation description

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false