Parallels RAS PowerShell - Getting Started

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

SYNOPSIS

Adds an Exclude AD group entry.

SYNTAX

Add-RASExcludeADGroup [-Account <string>] [-SID <string>] [-SiteId <uint>] [<CommonParameters>]

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.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    false

        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-RASExcludeADGroup -Account Guests

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

RELATED LINKS

• Remove-RASExcludeADGroup

• Get-RASExcludeADGroup

NAME

Add-RASAVDHostPoolAssignment

SYNOPSIS

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

SYNTAX

Add-RASAVDHostPoolAssignment [-Id] <uint> [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASAVDHostPoolAssignment [-InputObject] <AVDHostPool> [-Account <string>] [-SID <string>] [<CommonParameters>]

Add-RASAVDHostPoolAssignment [-Name] <string> [[-SiteId] <uint>] [-Account <string>] [-SID <string>] [<CommonParameters>]

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.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <AVDHostPool> An object of type AVDHostPool for which to modify settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    false

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

• Get-RASAVDHostPool

• Set-RASAVDHostPool

• Get-RASAVDHostPoolAssignment

• Remove-RASAVDHostPoolAssignment

NAME

Get-RASAppPackageAvailVersions

SYNOPSIS

Retrieves the application package version.

SYNTAX

Get-RASAppPackageAvailVersions [-Name] <string> [[-SiteId] <uint>] [<CommonParameters>]

DESCRIPTION

Retrieves the application package version.

PARAMETERS

-Name <string> The name of the application package for which to retrieve the available versions.

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

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> The ID of the Site from which to retrieve the available application package versions.

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

<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

AppPackageVersion

EXAMPLES

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

Get-RASAppPackageAvailVersions

Retrieves the list of application package versions. ---------- EXAMPLE 2 ----------

Get-RASAppPackageAvailVersions -Name "MSIX_APP_PACKAGE"

Retrieves the version of the application package named AppPackage1.

RELATED LINKS

-none-

NAME

Get-RASAVDResourceGroup

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Resource Groups.

SYNTAX

Get-RASAVDResourceGroup -ProviderId <uint> [<CommonParameters>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Resource Groups.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop Resource Group information.

        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

AVDResourceGroup

EXAMPLES

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

Get-RASAVDResourceGroup -ProviderId 2 | Format-List

Retrieves all the Resource Groups under the Provider with ID 2.

The Format-List cmdlet formats the display output to include all available properties.

RELATED LINKS

• New-RASAVDResourceGroup

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:

Getting Started lists system requirements and explains basic RAS PowerShell concepts.

Parallels RAS Powershell Admin Module is a complete reference to RAS PowerShell cmdlets.

API Versions lists available API versions and changes between them.

Examples 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 https://www.parallels.com/products/ras/resources

© 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

Get-RASAdminSession

SYNOPSIS

Retrieves information about RAS Admin sessions.

SYNTAX

-none-

DESCRIPTION

Retrieves information about RAS Admin sessions.

PARAMETERS

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAdminSession

Retrieves information about RAS Admin sessions.

RELATED LINKS

NAME

Get-RASAllowedDevicesSetting

SYNOPSIS

Returns settings for types of allowed clients.

SYNTAX

Get-RASAllowedDevicesSetting [- <uint>] [<>]

DESCRIPTION

Returns settings for types of allowed clients.

PARAMETERS

-SiteId <uint> The site ID.

To obtain the ID of a desired site, use the Get-Sites cmdlet.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAllowedDevicesSetting

Retrieves settings for each of device types shown in 'Allowed Devices'. The permission of the device is represented as a boolean.

RELATED LINKS

NAME

Get-RASAppPackageSettings

SYNOPSIS

Retrieves Application Package settings.

SYNTAX

Get-RASAppPackageSettings [- <uint>] [<>]

DESCRIPTION

Retrieves the active Application Package settings for the current site.

PARAMETERS

-SiteId <uint> The ID of the Site from which to retrieve the application package settings.

To obtain the ID of the desired Site, use the Get-Sites cmdlet.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAppPackageSettings

Obtains the active Application package settings for the current site.

RELATED LINKS

NAME

Get-RASAVDCustomHost

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Custom Hosts.

SYNTAX

Get-RASAVDCustomHost - <uint> [- <SwitchParameter>] [<>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Custom Hosts.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop Custom Host information.

-ShowHostsInHostPool <SwitchParameter> Show Hosts in existing host pools.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDCustomHost -ProviderId 2 | Format-List

Retrieves all the Custom Hosts under the Provider with ID 2.

The Format-List cmdlet formats the display output to include all available properties.

RELATED LINKS

-none-

NAME

Get-RASAVDLocation

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Locations.

SYNTAX

Get-RASAVDLocation - <uint> [<>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Locations.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop Location information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDLocation -ProviderId 2 | Format-List

Retrieves all the Locations under the Provider with ID 2.

The Format-List cmdlet formats the display output to include all available properties.

RELATED LINKS

-none-

NAME

Get-RASAVDPredefinedImages

SYNOPSIS

Retrieves the predefined Azure Virtual Desktop VM images.

SYNTAX

-none-

DESCRIPTION

The cmdlet returns the predefined Azure Virtual Desktop VM images.

To retrieve the AzureId of the Latest Predefined Image, use the Get-RASAVDVersion command and pass along the respective data.

PARAMETERS

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDPredefinedImages

Retrieves information about the predefined AVD VM images.

RELATED LINKS

NAME

Get-RASAVDVirtualNetwork

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Virtual Networks.

SYNTAX

Get-RASAVDVirtualNetwork - <string> - <uint> [<>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Virtual Networks.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop Virtual Network information.

-Location <string> Location of the Azure Virtual Desktop Provider.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDVirtualNetwork -ProviderId 2 -Location "westeurope" | Format-List

Retrieves all the Virtual Networks found under the Provider with ID 2 and Location westeurope.

The Format-List cmdlet formats the display output to include all available properties.

RELATED LINKS

-none-

NAME

Get-RASBrokerAutoPromotionSettings

SYNOPSIS

Obtains Parallels RAS Broker Auto Promotion settings.

SYNTAX

Get-RASBrokerAutoPromotionSettings [[-] <uint>] [<>]

DESCRIPTION

The Get-RASBrokerAutoPromotionSettings cmdlet obtains the complete set of Parallels RAS Broker Auto Promotion settings for the current session.

PARAMETERS

-SiteId <uint> Site ID from which to retrieve the specified RAS Auto Promotion settings.

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

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASBrokerAutoPromotionSettings

Obtains Parallels RAS Auto Promote settings for the current session.

RELATED LINKS

NAME

Get-RASClientPolicyConnection

SYNOPSIS

Retrieves the connection list.

SYNTAX

Get-RASClientPolicyConnection [-] <uint> [<>]

Get-RASClientPolicyConnection [[-] <string>] [<>]

DESCRIPTION

Retrieves the connection list.

PARAMETERS

-Name <string> Name of the client policy for which to retrieve the information.

-Id <uint> The ID of the client policy for which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASClientPolicyConnection -Id 1

Retrieves the following client policy connection with Id=1.

RELATED LINKS

NAME

Get-RASCPUOptimizationSettings

SYNOPSIS

Obtains Parallels RAS CPU Optimization settings.

SYNTAX

Get-RASCPUOptimizationSettings [- <uint>] [<>]

DESCRIPTION

The Get-RASCPUOptimizationSettings cmdlet obtains the complete set of CPU optimization settings for the current session.

PARAMETERS

-SiteId <uint> The site ID.

To obtain the ID of a desired site, use the Get-Sites cmdlet.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASCPUOptimizationSettings

Obtains Parallels RAS CPU optimization settings for the current session.

RELATED LINKS

NAME

Add-RASPrintingAutoInstallFont

SYNOPSIS

Adds an Auto install font to Parallels RAS Universal Printing settings.

SYNTAX

Add-RASPrintingAutoInstallFont -FontFilePath <string> [-ExcludeFont <SwitchParameter>] [-SiteId <uint>] [<CommonParameters>]

DESCRIPTION

Adds an Auto install font to Parallels RAS Universal Printing settings.

PARAMETERS

-SiteId <uint> The site ID.

To obtain the ID of a desired site, use the Get-Sites cmdlet.

        Required?                    false

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-FontFilePath <string> Auto Install Font Path.

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ExcludeFont <SwitchParameter> Automatically Exclude Font from embedding.

        Required?                    false

        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-RASPrintingAutoInstallFont -FontFilePath "C:\Windows\Fonts\arialbd.ttf"

Adds the font to RAS Universal Printing Auto install fonts settings. ---------- EXAMPLE 2 ----------

Add-RASPrintingAutoInstallFont -FontFilePath "C:\Windows\Fonts\arialbd.ttf" -ExcludeFont

Adds the font to RAS Universal Printing Auto install fonts settings and adds the font to the embedding exclusion list.

RELATED LINKS

• Get-RASPrintingSettings

• Set-RASPrintingSettings

• Get-RASPrintingAutoInstallFont

• Remove-RASPrintingAutoInstallFont

NAME

Get-RASADIntegrationSettings

SYNOPSIS

Obtains AD integration settings.

SYNTAX

Get-RASADIntegrationSettings [-SiteId <uint>] [<CommonParameters>]

DESCRIPTION

Obtains the active AD integration settings for the current site.

PARAMETERS

-SiteId <uint> Site ID from which to retrieve the AD Integration Settings.

To obtain the ID of a desired site, use the Get-Sites cmdlet.

        Required?                    false

        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

ADIntegrationSettings

EXAMPLES

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

Get-RASADIntegrationSettings

Obtains the active AD integration settings for the current site.

RELATED LINKS

• Set-RASADIntegrationSettings

• Invoke-RASADIntegrationSettings

NAME

Get-RASAVDDefaultSettings

SYNOPSIS

Retrieves default settings used to configure an Azure Virtual Desktop.

SYNTAX

Get-RASAVDDefaultSettings [[-SiteId] <uint>] -DefObjType {AVDMultiSessionDefaultSettings | AVDSingleSessionDefaultSettings} [<CommonParameters>]

DESCRIPTION

Retrieves default settings used to configure an Azure Virtual Desktop.

Default settings are defined on a site level and are applied to an Azure Virtual Desktop when it is initially created.

PARAMETERS

-SiteId <uint> Site ID from which to retrieve the defaults.

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

        Required?                    false

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <AVDDefObjType> The Default Object Type

Possible values: AVDMultiSessionDefaultSettings, AVDSingleSessionDefaultSettings

        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

AVDDefaultSettings

EXAMPLES

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

Get-RASAVDDefaultSettings -DefObjType AVDSingleSessionDefaultSettings

Retrieves default Personal AVD settings from the specified site. ---------- EXAMPLE 2 ----------

Get-RASAVDDefaultSettings -DefObjType AVDMultiSessionDefaultSettings

Retrieves default Pooled AVD settings from the specified site.

RELATED LINKS

• Set-RASAVDDefaultSettings

NAME

Get-RASAVDGallery

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Galleries.

SYNTAX

Get-RASAVDGallery -ProviderId <uint> [<CommonParameters>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Galleries.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop Gallery information.

        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

AVDGallery

EXAMPLES

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

Get-RASAVDGallery -ProviderId 2

Retrieves a list of Galleries which fall under the Provider specified.

RELATED LINKS

-none-

NAME

Get-RASAVDVMSize

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop VM Sizes.

SYNTAX

Get-RASAVDVMSize -Location <string> -ProviderId <uint> [<CommonParameters>]

Get-RASAVDVMSize -VMAzureId <string> -WorkspaceId <uint> [<CommonParameters>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop VM Sizes.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop VMSize information.

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Location <string> Location of the Azure Virtual Desktop Provider.

        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-WorkspaceId <uint> Workspace ID from which to retrieve the Azure Virtual Desktop VMSize information.

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-VMAzureId <string> Azure Virtual Desktop VM Id.

        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

AVDVMSize

EXAMPLES

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

Get-RASAVDVMSize -ProviderId 2 -Location westeurope | Format-List

Retrieves all the VM Sizes which fall under the AVD Provider and Location specified.

The Format-List cmdlet formats the display output to include all available properties. ---------- EXAMPLE 2 ----------

Get-RASAVDVMSize -WorkspaceId 2 -VMAzureId "/subscriptions/w7647456-39g5-113d-pe43-34le8xwj92tn/resourceGroups/My-Resource-Group/providers/Microsoft.Compute/virtualMachines/My-Host"

Retrieves all the VM Sizes which fall under the AVD Workspace and VMAzure specified.

RELATED LINKS

-none-

NAME

Get-RASClientSettings

SYNOPSIS

Retrieves the Parallels RAS client settings.

SYNTAX

Get-RASClientSettings [-SiteId <uint>] [<CommonParameters>]

DESCRIPTION

Retrieves the Parallels RAS client settings.

PARAMETERS

-SiteId <uint> The site ID.

To obtain the ID of a desired site, use the Get-Sites cmdlet.

        Required?                    false

        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

RASClientSettings

EXAMPLES

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

Get-RASClientSettings

Retrieves the RAS Farm client settings. ---------- EXAMPLE 2 ----------

Get-RASClientSettings | Format-List

Retrieves the RAS client settings.

RELATED LINKS

• Get-RASHelpDeskEmailSettings

• Get-RASProxySettings

• Get-RASSystemSettings

• Set-RASClientSettings

• Get-RASFarmSettings

NAME

Get-RASAuthSettings

SYNOPSIS

Retrieves connection settings for authentication.

SYNTAX

Get-RASAuthSettings [-SiteId <uint>] [<CommonParameters>]

DESCRIPTION

Retrieves all of the available connection settings for the Authentication category.

PARAMETERS

-SiteId <uint> The site ID.

To obtain the ID of a desired site, use the Get-Sites cmdlet.

        Required?                    false

        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

RASAuthSettings

EXAMPLES

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

Get-RASAuthSettings

Retrieves RAS authentication settings.

RELATED LINKS

• Set-RASAuthSettings

NAME

Get-RASCurrentAdminPermissions

SYNOPSIS

Retrieve information about the current admin permissions.

SYNTAX

-none-

DESCRIPTION

The cmdlet returns the current admin permissions.

PARAMETERS

<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

CurrentAdminPermissions

EXAMPLES

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

Get-RASCurrentAdminPermissions

Retrieves information about the current admin permissions.

RELATED LINKS

• New-RASSession

• Remove-RASSession

NAME

Get-RASAVDSettings

SYNOPSIS

Retrieves the Azure Virtual Desktop Features settings.

SYNTAX

Get-RASAVDSettings [-SiteId <uint>] [<CommonParameters>]

DESCRIPTION

Retrieves the Azure Virtual Desktop Features settings.

PARAMETERS

-SiteId <uint> Site ID from which to retrieve the AVD settings.

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

        Required?                    false

        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

AVDFeaturesSettings

EXAMPLES

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

Get-RASAVDSettings

Retrieves the AVD Features Settings.

RELATED LINKS

• Set-RASAVDSettings

NAME

Add-RASImageOptimizationWindowsScheduledTask

SYNOPSIS

Adds Windows Schedule Task.

SYNTAX

Add-RASImageOptimizationWindowsScheduledTask - {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} - <string> - <string> [- <uint>] [<>]

Add-RASImageOptimizationWindowsScheduledTask [-] <uint> - <string> - {RDSHost | RDS | VDIHostPool | AVDHostPool | RDSTemplate | VDITemplate | AVDTemplate} - <string> [<>]

Add-RASImageOptimizationWindowsScheduledTask [-] <> - <string> - <string> [<>]

Add-RASImageOptimizationWindowsScheduledTask [-] <string> [[-] <uint>] - <string> - {RDSHost | RDS | VDIHostPool | AVDHostPool | RDSTemplate | VDITemplate | AVDTemplate} - <string> [<>]

DESCRIPTION

Adds Windows Schedule Task to the following list.

PARAMETERS

-Task <string>

-Location <string>

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

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

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

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

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

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

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

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

<CommonParameters>

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

NAME

Add-RASAppPackageAssigned

SYNOPSIS

Assigns an application package to an object type.

SYNTAX

Add-RASAppPackageAssigned - {RDSDef | VDIDef | AVDSingleSessionDefaultSettings | AVDMultiSessionDefaultSettings | VDIGuestDef} - <string> - <string> [- <uint>] [<>]

Add-RASAppPackageAssigned [-] <uint> - {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} - <string> - <string> [<>]

Add-RASAppPackageAssigned [-] <> - <string> - <string> [<>]

Add-RASAppPackageAssigned [-] <string> [[-] <uint>] - {RDSHost | RDS | RDSHostPool | RDSGroup | VDIHostPool | VDIPool | AVDHostPool} - <string> - <string> [<>]

DESCRIPTION

Adds assigned application package to an object type.

PARAMETERS

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

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

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

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

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

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

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

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

-PackageName <string> The application package name.

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

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

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

<CommonParameters>

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

NAME

Add-RASTemplateLicenseKey

SYNOPSIS

Modifies properties of a RAS Template license key.

SYNTAX

Add-RASTemplateLicenseKey [-] <uint> - <string> - <uint> - {RDSTemplate | VDITemplate | AVDTemplate} [<>]

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

DESCRIPTION

Modifies properties of a license key used by a RAS Template.

PARAMETERS

-Id <uint> The ID of a RAS Template to modify.

-ObjType <> The Object Type for which to add Template License Key.

Possible values: RDSTemplate, VDITemplate, AVDTemplate

-InputObject <> An object of type Template representing a RAS Template.

The object is obtained using the Get-Template cmdlet.

-Key <string> The license key.

-KeyLimit <uint> The max limit for the license key.

<CommonParameters>

INPUTS

OUTPUTS

-none-

EXAMPLES

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

Add-RASTemplateLicenseKey -ObjType VDITemplate -Id 1 -Key abcd1234 -KeyLimit 25

Modifies the specified license key properties for a RAS Template specified by ObjType and ID. ---------- EXAMPLE 2 ----------

Add-RASTemplateLicenseKey -InputObject $Template -Key abcd1234 -KeyLimit 25

Modifies the specified license key properties for a RAS Template specified by the Object Type variable. ---------- EXAMPLE 3 ----------

Get-RASTemplate -ObjType VDITemplate -Id 1 | Add-RASTemplateLicenseKey -Key abcd1234 -KeyLimit 25

Modifies the specified license key properties for a RAS Template obtained from the pipeline output.

RELATED LINKS

NAME

Add-RASThemeGroupFilter

SYNOPSIS

Adds a new group filter to the theme group filters.

SYNTAX

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

Add-RASThemeGroupFilter [-] <string> [- <string>] [- <string>] [<>]

DESCRIPTION

Adds a new group filter to the theme group filters.

PARAMETERS

-GroupName <string> The name of the group list

-GroupSID <string> The group SID

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

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

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

<CommonParameters>

INPUTS

-none-

OUTPUTS

-none-

EXAMPLES

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

Add-RASThemeGroupFilter -Id 1 -GroupName GroupListName

Adds a group filter with name GroupListName for theme with Id 1.

RELATED LINKS

NAME

Copy-RASPubItem

SYNOPSIS

Copy a Published item.

SYNTAX

Copy-RASPubItem - <uint> [- <uint>] [- <uint>] [<>]

Copy-RASPubItem [-] <> [- <uint>] [- <uint>] [<>]

DESCRIPTION

Copy (duplicate) a published item.

PARAMETERS

-Id <uint> ID of Pub item to duplicate.

To obtain the pub item ID, use the Get-PubItem command.

-InputObject <> The published item object.

To obtain a PubItem object representing a published item, use the Get-PubItem command.

-ParentId <uint> ID of a new parent published item.

To obtain the published item ID, use the Get-PubItem command.

-PreviousId <uint> ID of a sibling item after which to place the specified published item.

To obtain the sibling item ID, use the Get-PubItem command.

<CommonParameters>

INPUTS

OUTPUTS

EXAMPLES

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

Copy-RASPubItem -Id 5 -ParentId 12

Duplicate the specified published item and it under the specified parent (ParentId).

To obtain the parent item ID, use the Get-RASPubItem cmdlet. ---------- EXAMPLE 2 ----------

Copy-RASPubItem -Id 10 -ParentId 12 -PreviousId 22

Duplicate a published item and place it under the specified parent (ParentId) and after the specified sibling item (PreviousId).

To obtain the parent item ID, use the Get-RASPubItem cmdlet. ---------- EXAMPLE 3 ----------

$PubItem | Copy-RASPubItem -ParentId 12

Invoke the duplicate pub item command, which is identified by an object obtained from the pipeline output.

To obtain the parent item ID, use the Get-RASPubItem cmdlet.

RELATED LINKS

NAME

Get-RASAdminAccount

SYNOPSIS

Retrieves information about one or multiple Parallels RAS administrator accounts.

SYNTAX

Get-RASAdminAccount [[-] <uint>] [<>]

Get-RASAdminAccount [[-] <string>] [<>]

DESCRIPTION

Retrieves information about one or multiple Parallels RAS administrator accounts.

The cmdlet returns an array of objects of type RASAdminAccount.

To see the complete list of object properties, use the Format-List cmdlet (see examples).

PARAMETERS

-Name <string> The username of a Parallels RAS administrator account for which to retrieve the information.

-Id <uint> The ID of an administrator account for which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAdminAccount | Format-List

Retrieves the list of all available Parallels RAS administrator accounts.

The Format-List cmdlet formats the display output to include all available settings for each administrator. ---------- EXAMPLE 2 ----------

Get-RASAdminAccount "username@dom"

Retrieves information about an administrator specified by username. ---------- EXAMPLE 3 ----------

Get-RASAdminAccount -Id 1

Retrieves information about an administrator specified by ID.

RELATED LINKS

NAME

Get-RASAppPackage

SYNOPSIS

Retrieves the application package settings.

SYNTAX

Get-RASAppPackage [-] <uint> [<>]

Get-RASAppPackage [[-] <string>] [[-] <uint>] [<>]

DESCRIPTION

Retrieves the application package settings.

PARAMETERS

-Name <string> The name of the application package from which to retrieve the information.

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

-SiteId <uint> The ID of the Site from which to retrieve the application package information.

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

-Id <uint> The ID of an application package from which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAppPackage

Retrieves the list of Application Packages. ---------- EXAMPLE 2 ----------

Get-RASAppPackage -Id 1

Retrieves the Application Package with Id 1.

RELATED LINKS

NAME

Get-RASAVDGalleryImage

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Gallery Images.

SYNTAX

Get-RASAVDGalleryImage - <string> - <string> - <uint> - <string> [<>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Gallery Images.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop VMSize information.

-Name <string> Name of the Azure Virtual Desktop Gallery.

-ResourceGroup <string> Resource Group of the Azure Virtual Desktop Gallery Image.

-Location <string> Location of the Azure Virtual Desktop Gallery Image.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDGalleryImage -ProviderId 2 -Location "westeurope" -Name "myGalleryImage" -ResourceGroup "myResourceGroup"

Retrieves a list of Gallery Images which fall under the Provider, Location, ProviderId and ResourceGroup specified.

RELATED LINKS

-none-

NAME

Get-RASAVDHostPool

SYNOPSIS

Retrieves information about one or multiple Azure Virtual Desktop Host Pool properties.

SYNTAX

Get-RASAVDHostPool [[-] <uint>] [<>]

Get-RASAVDHostPool [[-] <string>] [[-] <uint>] [<>]

DESCRIPTION

The cmdlet returns an object of type Azure Virtual Desktop Host Pool properties.

To see the complete list of object properties, use the Format-List cmdlet (see examples).

The result set contains only the major properties of a pool; it does not include the complete list of settings supported in RAS.

PARAMETERS

-Name <string> The name of the Azure Virtual Desktop Host Pool for which to retrieve the information.

This must be the actual AVD Host Pool name used in the RAS farm.

-SiteId <uint> Site ID from which to retrieve the AVD Host Pool information.

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

-Id <uint> The ID of a Azure Virtual Desktop Host Pool for which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDHostPool -Name "My AVDHostPool" | Format-List

Retrieves information about the AVD Host Pool properties specified by name from the Licensing Server site. ---------- EXAMPLE 2 ----------

Get-RASAVDHostPool -Id 10

Retrieves information about the AVD Host Pool specified by ID from the Licensing Server site.

RELATED LINKS

NAME

Get-RASAVDHostPoolStatus

SYNOPSIS

Retrieves the status of one or multiple Azure Virtual Desktop Host Pools.

SYNTAX

Get-RASAVDHostPoolStatus [[-] <uint>] [<>]

Get-RASAVDHostPoolStatus [[-] <>] [<>]

Get-RASAVDHostPoolStatus [[-] <string>] [[-] <uint>] [<>]

DESCRIPTION

Retrieves information about the status of one or multiple Azure Virtual Desktop Host Pools.

The cmdlet returns an object of type AVDHostPoolStatus.

To see the complete list of object properties, use the Format-List cmdlet (see examples).

The result set contains only the major properties of a group; it does not include the complete list of settings supported in RAS.

PARAMETERS

-Name <string> The name of the AVD Host Pool for which to retrieve the status.

-SiteId <uint> Site ID from which to retrieve the specified RDS Host Pool Name.

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

-Id <uint> The ID of the AVD Host Pool. To obtain the ID, use the Get-RASAVDHostPool cmdlet.

-InputObject <> An object of type AVDHostPool representing the AVD Host Pool.

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

<CommonParameters>

INPUTS

OUTPUTS

EXAMPLES

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

Get-RASAVDHostPoolStatus "My AVD Host Pool" | Format-List

Retrieves the status of the AVD Host Pool specified by name from the Licensing Server site.

To retrieve the info from a specific site, specify the -SiteId parameter.

The Format-List cmdlet formats the display output to include all available pool properties. ---------- EXAMPLE 2 ----------

Get-RASAVDHostPoolStatus -Id 10

Retrieves the status information about the AVD Host Pool specified by Id from the Licensing Server site.

RELATED LINKS

NAME

Get-RASAVDSKU

SYNOPSIS

The cmdlet returns a list of Azure Virtual Desktop Stock Keeping Units.

SYNTAX

Get-RASAVDSKU - <string> - <string> - <uint> - <string> [<>]

DESCRIPTION

The cmdlet returns a list of Azure Virtual Desktop Stock Keeping Units.

PARAMETERS

-ProviderId <uint> Provider ID from which to retrieve the Azure Virtual Desktop Stock Keeping Unit information.

-Location <string> Location of the Azure Virtual Desktop Provider.

-Publisher <string> The Azure Virtual Desktop Publisher.

-Offer <string> The Azure Virtual Desktop Offer.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDSKU -ProviderId 2 -Location "westeurope" -Publisher "my-publisher" -Offer "my-offer"

Retrieves a list of Stock Keeping Units which fall under the Provider, Location, Publisher and Offer specified.

RELATED LINKS

-none-

NAME

Get-RASAVDWorkspace

SYNOPSIS

Retrieves information about an Azure Virtual Desktop Workspace.

SYNTAX

Get-RASAVDWorkspace [[-] <uint>] [<>]

Get-RASAVDWorkspace [[-] <string>] [[-] <uint>] [<>]

DESCRIPTION

Retrieves information about the specified Azure Virtual Desktop Workspace or all Azure Virtual Desktop Workspaces within a site.

PARAMETERS

-Name <string> The name of the Azure Virtual Desktop Workspace for which to retrieve the information.

This must be the actual Azure Virtual Desktop Workspace name.

-SiteId <uint> Site ID from which to retrieve the Azure Virtual Desktop Workspace information.

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

-Id <uint> The ID of a Azure Virtual Desktop Workspace for which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASAVDWorkspace -SiteId 1

Retrieves information about all the AVD Workspaces found withing the site with ID 1. ---------- EXAMPLE 2 ----------

Get-RASAVDWorkspace "My AVDWorkspace" -SiteId 1 | Format-List

Retrieves information about the AVD Workspace specified by name from the site with ID 1.

The Format-List cmdlet formats the display output to include all available properties. ---------- EXAMPLE 3 ----------

Get-RASAVDWorkspace -Id 10

Retrieves information about the AVD Workspace specified by ID from the Licensing Server site.

To retrieve the info from a specific site, specify the -SiteId parameter.

RELATED LINKS

NAME

Get-RASBroker

SYNOPSIS

Retrieves information about one or multiple RAS Connection Broker servers.

SYNTAX

Get-RASBroker [[-] <uint>] [<>]

Get-RASBroker [[-] <string>] [[-] <uint>] [<>]

DESCRIPTION

Retrieves the information about one or multiple RAS Connection Broker servers.

It returns an array of objects of type Broker, each containing properties of a RAS Connection Broker server.

To see the complete list of object properties, use the Format-List cmdlet (see examples).

Note: the result set contains only the major server properties; it does not include all of the settings supported in RAS.

PARAMETERS

-Server <string> The name of the RAS Connection Broker server for which to retrieve the information.

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

-SiteId <uint> Site ID from which to retrieve the RAS Connection Broker server information.

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

-Id <uint> The ID of the RAS Connection Broker server for which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASBroker "server.company.dom" | Format-List

Retrieves properties of the specified RAS Connection Broker server.

The Format-List cmdlet formats the display output to include all available server properties. ---------- EXAMPLE 2 ----------

Get-RASBroker -Id 5

Retrieves properties of the RAS Connection Broker server specified by ID.

RELATED LINKS

NAME

Get-RASClientPolicyAssignment

SYNOPSIS

Retrieves information about a client policy assignment.

SYNTAX

Get-RASClientPolicyAssignment [-] <uint> [<>]

Get-RASClientPolicyAssignment [-] <string> [<>]

DESCRIPTION

Retrieves information about a client policy assignment.

PARAMETERS

-Name <string> Name of the client policy for which to retrieve the information.

-Id <uint> The ID of the client policy for which to retrieve the information.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASClientPolicyAssignment -Name PDFPolicy

Retrieves information about the assignment from a client policy named PDFPolicy.

RELATED LINKS

NAME

Get-RASCustomPermission

SYNOPSIS

Retrieves the permissions of a RAS custom admin account.

SYNTAX

Get-RASCustomPermission [-] <uint> [<>]

DESCRIPTION

Retrieves the permissions of a RAS custom admin account.

PARAMETERS

-AdminId <uint> Admin ID to retrieve the specified RAS Custom Administrator Account.

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

Get-RASCustomPermission -AdminId 100

Retrieves the permissions of a custom administrator specified by ID.

RELATED LINKS

NAME

Add-RASCriteriaDevice

SYNOPSIS

Adds a Client Device to the Criteria Device List.

SYNTAX

Add-RASCriteriaDevice [-DefObjType] {MFA} [[-SiteId] <uint>] -ClientDeviceName <string> [<CommonParameters>]

Add-RASCriteriaDevice [-Id] <uint> -ClientDeviceName <string> -ObjType {ClientPolicy | PubItem | MFA | LogonHours} [-RuleId <uint>] [<CommonParameters>]

Add-RASCriteriaDevice [-InputObject] <RASListObj> -ClientDeviceName <string> [-RuleId <uint>] [<CommonParameters>]

Add-RASCriteriaDevice [-Name] <string> [[-SiteId] <uint>] -ClientDeviceName <string> -ObjType {ClientPolicy | PubItem | MFA | LogonHours} [-RuleId <uint>] [<CommonParameters>]

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.

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

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID for which to modify the Criteria 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 Criteria settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASListObj> An object of type ClientPolicy, PubItem or MFA for which to modify the Criteria settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <CriteriaObjType> The Object Type for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <CriteriaDefObjType> The Default Object Type for which to modify the Criteria settings.

Possible values: MFA

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

        Required?                    false

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

• Get-RASCriteria

• Set-RASCriteria

• Get-RASCriteriaDevice

• Remove-RASCriteriaDevice

NAME

Add-RASCriteriaGatewayIP

SYNOPSIS

Adds a Gateway IP to the Criteria Gateway List.

SYNTAX

Add-RASCriteriaGatewayIP [-DefObjType] {MFA} [[-SiteId] <uint>] [-GatewayId <uint>] [-IP <string>] [<CommonParameters>]

Add-RASCriteriaGatewayIP [-Id] <uint> -ObjType {ClientPolicy | PubItem | MFA | LogonHours} [-GatewayId <uint>] [-IP <string>] [-RuleId <uint>] [<CommonParameters>]

Add-RASCriteriaGatewayIP [-InputObject] <RASListObj> [-GatewayId <uint>] [-IP <string>] [-RuleId <uint>] [<CommonParameters>]

Add-RASCriteriaGatewayIP [-Name] <string> [[-SiteId] <uint>] -ObjType {ClientPolicy | PubItem | MFA | LogonHours} [-GatewayId <uint>] [-IP <string>] [-RuleId <uint>] [<CommonParameters>]

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.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

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

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

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID for which to modify the Criteria 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 Criteria settings.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <RASListObj> An object of type ClientPolicy, PubItem or MFA for which to modify the Criteria settings.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-ObjType <CriteriaObjType> The Object Type for which to modify the Criteria settings.

Possible values: ClientPolicy, PubItem, MFA, LogonHours

        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-DefObjType <CriteriaDefObjType> The Default Object Type for which to modify the Criteria settings.

Possible values: MFA

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false