New-RASEnrollmentServer

NAME

New-RASEnrollmentServer

SYNOPSIS

Creates a new Enrollment server.

SYNTAX

New-RASEnrollmentServer [-Server] <string> [[-SiteId] <uint>] [-Description <string>] [-Enabled <bool>] [-NoFireWallRules <SwitchParameter>] [-NoInstall <SwitchParameter>] [<CommonParameters>]

New-RASEnrollmentServer [-Server] <string> [[-SiteId] <uint>] -Password <SecureString> -Username <string> [-Description <string>] [-Enabled <bool>] [-NoFireWallRules <SwitchParameter>] [<CommonParameters>]

DESCRIPTION

To create an Enrollment server from a specific site, specify the -SiteId parameter.

PARAMETERS


-Server <string>
The name of the target enrollment server.

This must be the actual enrollment server name used in the RAS farm.

        Required?                    true
        Position?                    0
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-SiteId <uint>
Site ID in which to create the specified enrollment server.

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

        Required?                    false
        Position?                    1
        Default value                0
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Enabled <bool>
Enable or disable the enrollment server upon creation.

If the parameter is omitted, the enrollment server is initialised as disabled.

        Required?                    false
        Position?                    named
        Default value                False
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Description <string>
The enrollment server description.

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Username <string>
An administrator account for remote installing the enrollment agent on the server.

If this parameter is omitted, the user's RAS admin username and password will be used.

        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Password <SecureString>
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 enrollment agent on the server.

If this parameter is omitted, the enrollment server will be push installed on the server using the user's 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

-NoFireWallRules <SwitchParameter>
If this parameter is omitted, the firewall rules will be added.

        Required?                    false
        Position?                    named
        Default value                False
        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

EnrollmentServer

EXAMPLES


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

New-RASEnrollmentServer -Id 2 -Server "MyServer"

Creates a new Enrollment server with the specified name.

RELATED LINKS