All pages
Powered by GitBook
1 of 1

Loading...

New-RASSession

NAME

New-RASSession

SYNOPSIS

Creates a connection with a Parallels RAS farm.

SYNTAX

New-RASSession [-] <string> [-] <SecureString> [[-] <string>] [- <SwitchParameter>] [- <uint>] [<>]

New-RASSession [<>]

DESCRIPTION

Connects to a Parallels RAS farm and creates a new RAS session.

A connection with Parallels RAS must be established before you can execute any other commands.

PARAMETERS

-Server <string> FQDN or IP address of the server where your have Parallels RAS installed.

-Username <string> Parallels RAS administrator username.

-Password <SecureString> Parallels RAS administrator password.

-Retries <uint> Number of reconnections to do if the first one fails. Default is 0.

-Force <SwitchParameter> Force connection with specified server (or with local host if server not specified).

<CommonParameters>

INPUTS

-none-

OUTPUTS

EXAMPLES

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

New-RASSession "username"

Creates a new RAS session with the Parallels RAS farm deployed on the local server.

When you execute the command, you will get a prompt to enter a password. ---------- EXAMPLE 2 ----------

New-RASSession -Username "[email protected]" -Password $SecretPassword -Server "192.168.10.200"

Connects to the specified server using specified credentials and creates a new RAS session.

The -Username value must be specified using the UPN format.

The $SecretPassword variable must contain a valid password as SecureString. ---------- EXAMPLE 3 ----------

New-RASSession -Username "[email protected]" -Password $SecretPassword -Server "192.168.10.200" -Retries 3

Connects to the specified server using specified credentials and creates a new RAS session.

The -Retries value specifies how many retries to do, in case connection is not established the first time.

The -Username value must be specified using the UPN format.

The $SecretPassword variable must contain a valid password as SecureString.

RELATED LINKS

Username
Password
Server
Force
Retries
CommonParameters
CommonParameters
Session
Remove-RASSession
Invoke-RASLicenseActivate
Invoke-RASApply
Get-RASCurrentAdminPermissions
        Required?                    false

        Position?                    2

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
        Required?                    true

        Position?                    1

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
        Required?                    false

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
        Required?                    false

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false
        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

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

        about_CommonParameters documentation.