# New-RASBroker

## NAME

New-RASBroker

## SYNOPSIS

Adds a RAS Connection Broker server to a site.

## SYNTAX

**New-RASBroker** \[[Server](#server-string)] _(string)_\*\*\
\[\[-[SiteId](#siteid-string)] _(uint)_]\
\[[NoFireWallRules](#nofirewallrules-string)_(SwitchParameter)_] \[[NoInstall](#noinstall-string)_(SwitchParameter)_] \[[NoRestart](#norestart-string)_(SwitchParameter)_] \[[Takeover](#takeover-string)_(SwitchParameter)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

**New-RASBroker** \[[Server](#server-string)] _(string)_\*\*\
\[\[-[SiteId](#siteid-string)] _(uint)_]\
-[Password](#password-string) _(SecureString)_\
-[Username](#username-string) _(string)_\
\[[NoFireWallRules](#nofirewallrules-string)_(SwitchParameter)_] \[[NoRestart](#norestart-string)_(SwitchParameter)_] \[[Takeover](#takeover-string)_(SwitchParameter)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

## DESCRIPTION

Adds a RAS Connection Broker server to a site.

The agent software will be installed on the server by default. You can\
optionally skip the agent installation by including the -NoInstall\
parameter.

## PARAMETERS

## Server (string)

FQDN or IP address of the server to add to a site as a RAS Connection\
Broker.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SiteId (uint)

Site ID to which to add the RAS Connection Broker server.

If the parameter is omitted, the Licensing Server site ID will be\
used.

```
        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Username (string)

An administrator account for push installing the agent on the server.

If this parameter is omitted, your RAS admin username and password will\
be used.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Password (SecureString)

The password of the account specified in the Username parameter.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## NoInstall (SwitchParameter)

Specifies not to install the agent software on the server.

If you omit this parameter, the agent will be push installed on the\
server using your RAS admin credentials.

To specify different credentials, include the Username and Password\
parameters.

```
        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 Connection Broker is\
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
```

## NoFireWallRules (SwitchParameter)

Specifies not to add firewall rules to allow the RAS Connection Broker\
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
```

## Takeover (SwitchParameter)

Specifies to takeover the RAS Connection Broker that is installed on the\
server, if installed.

If this parameter is omitted and the RAS Connection Broker is installed,\
this service will not be taken over.

```
        Required?                    false

        Position?                    named

        Default value                True

        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

[Broker](../types/broker)

## EXAMPLES

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

New-RASBroker "server.company.dom"

Adds the specified server to the Licensing Server site as a RAS\
Connection Broker.

The agent software will be installed on the server automatically.

To add a RAS Connection Broker to a specific site, add the -SiteId\
parameter.

## RELATED LINKS

* [Get-RASBroker](get-rasbroker)
* [Set-RASBroker](set-rasbroker)
* [Remove-RASBroker](remove-rasbroker)
