# New-RASSite

## NAME

New-RASSite

## SYNOPSIS

Adds a new site to the RAS farm.

## SYNTAX

**New-RASSite** \[[Server](#server-string)] _(string)_\*\*\
\[[Name](#name-string) _(string)_]\
\[[NoInstall](#noinstall-string) _(SwitchParameter)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

**New-RASSite** \[[Server](#server-string)] _(string)_\*\*\
-[Password](#password-string) _(SecureString)_\
-[Username](#username-string) _(string)_\
\[[Name](#name-string) _(string)_]\
\[[NoFireWallRules](#nofirewallrules-string)_(SwitchParameter)_] \[[NoRestart](#norestart-string)_(SwitchParameter)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

## DESCRIPTION

Adds a new site to the RAS farm.

When you add a site, you specify a server which will become the Site.

The cmdlet installs the Site software on a specified server by\
default.

If the server you are using already has the Site installed, you have an\
option to skip the agent installation.

## PARAMETERS

## Server (string)

The target server FQDN or IP address.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Name (string)

The name you want to use for the new site.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## NoInstall (SwitchParameter)

If this parameter is included, the Connection Broker software will not\
be installed on the target server.

You may use this option if the server already has the Connection Broker\
installed.

```
        Required?                    false

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## NoFireWallRules (SwitchParameter)

Specifies not to add firewall rules to allow the RAS Agent to\
communicate.

If this parameter is omitted, the firewall rules will not be added.

```
        Required?                    false

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## NoRestart (SwitchParameter)

Specifies not to restart the server after the RAS agents are\
installed.

If this parameter is omitted, the server will be restarted if\
required.

```
        Required?                    false

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Username (string)

A username to log in to the target server and push install the\
Connection Broker on it.

You must also specify the Password parameter.

If you've included the NoInstall parameter, you don't have to include\
the Username and Password parameters.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Password (SecureString)

The password for the user specified in the Username parameter.

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

[Site](../types/site)

## EXAMPLES

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

New-RASSite -Server "server.company.dom" -Name "My New Site"

Adds a site with a Site on "10.0.0.2"

## RELATED LINKS

* [Get-RASSite](get-rassite)
* [Set-RASSite](set-rassite)
* [Remove-RASSite](remove-rassite)
* [Invoke-RASSitePromoteToLicensing](invoke-rassitepromotetolicensing)
