# New-RASFarm

## NAME

New-RASFarm

## SYNOPSIS

Deploy a new farm on a remote server.

## SYNTAX

**New-RASFarm** -[Server](#server-string) *(string)*\*\* \[*(*[*CommonParameters*](#CommonParameters)*)*]

**New-RASFarm** -[Password](#password-string)\*\* *(SecureString)* -[Server](#server-string) *(string)* -[Username](#username-string) *(string)* \[*(*[*CommonParameters*](#CommonParameters)*)*]

## DESCRIPTION

Deploys a new farm with Powershell, Console, and Redundancy features installed.

When establishing a connection with a remote server for the first time, remote credentials must be provided. Subsequent New-RASFarm calls will not require credentials.

## PARAMETERS

## Server (string)

Remote server IP or domain name.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Username (string)

Remote server username.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Password (SecureString)

Remote server password.

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

New-RASFarm -Server server.company.dom

Deploy a new farm on server.company.dom

If the user is an Administrator, no remote credentials are needed.\
\&#xNAN;**---------- EXAMPLE 2 ----------**

New-RASFarm -Server server.company.dom -Username Administrator -Password $SecretPassword .

Deploy a new farm on server.company.dom with remote credentials specified.

## RELATED LINKS

* [Remove-RASFarm](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/remove-rasfarm)