New-RASSession
NAME
New-RASSession
SYNOPSIS
Creates a connection with a Parallels RAS farm.
SYNTAX
New-RASSession [-Username] <string> [-Password] <SecureString> [[-Server] <string>] [-Force <SwitchParameter>] [-Retries <uint>] [<CommonParameters>]
New-RASSession [<CommonParameters>]
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 "administrator@domain.dom" -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 "administrator@domain.dom" -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
Last updated