Invoke-RASClientPolicy.md

NAME

Invoke-RASClientPolicy

SYNOPSIS

Invokes an action on a client policy.

SYNTAX

Invoke-RASClientPolicy [Id] (uint) -Duplicate (SwitchParameter) [(CommonParameters)]

**Invoke-RASClientPolicy [-InputObject] (ClientRules) -Duplicate (SwitchParameter) [(CommonParameters)]

**Invoke-RASClientPolicy [Export] (SwitchParameter) [Id] (uint) [[-FilePath] (string)] [(CommonParameters)]

**Invoke-RASClientPolicy [Export] (SwitchParameter) [Name] (string) [[-FilePath] (string)] [(CommonParameters)]

**Invoke-RASClientPolicy [Import] (SwitchParameter) [[-InputMethod] {AddNew | Overwrite | AddWithNewName}] [(CommonParameters)]

**Invoke-RASClientPolicy [Import] (SwitchParameter) [FilePath] (string) [[-InputMethod] {AddNew | Overwrite | AddWithNewName}] [(CommonParameters)]

DESCRIPTION

Invokes an action on a client policy.

PARAMETERS

Id (uint)

The ID of the client policy to invoke the action on. To obtain the ID, use the Get-RASClientPolicy cmdlet.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

FilePath (string)

File name and path.

Use the '.xml' filename extension to be consistent with the Parallels RAS console.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

Duplicate (SwitchParameter)

Specifies the action to duplicate the Client Policy.

        Required?                    true

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

InputObject (ClientRules)

The client policy object to invoke the action on.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

Import (SwitchParameter)

Specifies the action to import the Client Policy(ies).

        Required?                    true

        Position?                    0

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

InputMethod

(ClientPolicyInputMethod) Overwrite the client policy if there is already another client policy with the same name.

Possible values: AddNew, Overwrite, AddWithNewName

        Required?                    false

        Position?                    0

        Default value                AddNew

        Accept pipeline input?       false

        Accept wildcard characters?  false

Export (SwitchParameter)

Specifies the action to import the Client Policy(ies).

        Required?                    true

        Position?                    0

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false

Name (string)

Name of the client policy to be exported.

        Required?                    true

        Position?                    0

        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

ClientRules

OUTPUTS

ClientRules

RASFiles

EXAMPLES

**---------- EXAMPLE 1 ----------

Invoke-RASClientPolicy -Id 1 -Duplicate

Adds a new client policy by duplicating the client policy with ID 1. **---------- EXAMPLE 2 ----------

Invoke-RASClientPolicy -Import "C:\Backup\PDF-clientpolicy.xml"

Imports a client policy from the specified file. **---------- EXAMPLE 3 ----------

Invoke-RASClientPolicy -Export -Name PDFPolicy -FilePath "C:\Backup\PDF-clientpolicy.xml"

Exports the client policy named PDFPolicy to the specified file.

RELATED LINKS

• Get-RASClientPolicy

• New-RASClientPolicy

• Set-RASClientPolicy

• Remove-RASClientPolicy