New-RASSite

NAME

New-RASSite

SYNOPSIS

Adds a new site to the RAS farm.

SYNTAX

New-RASSite [- Server ] <string> [- Name <string> ] [- NoInstall <SwitchParameter> ] [ < CommonParameters > ]

New-RASSite [- Server ] <string> - Password <SecureString> - Username <string> [- Name <string> ] [- NoFireWallRules <SwitchParameter> ] [- NoRestart <SwitchParameter> ] [ < CommonParameters > ]

DESCRIPTION

Adds a new site to the RAS farm.

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

The cmdlet installs the Connection Broker software on a specified server by default.

If the server you are using already has the Connection Broker 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

EXAMPLES


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

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

Adds a site with a Connection Broker on "10.0.0.2"

RELATED LINKS