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

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

• Set-RASSite

• Remove-RASSite

• Invoke-RASSitePromoteToLicensing