Edit

Share via

Add-CMEnrollmentPoint

Module:
ConfigurationManager Module

Adds an enrollment point to Configuration Manager.

Syntax

EnrollmentPointByValue (Default) 

Add-CMEnrollmentPoint
    -InputObject <IResultObject>
    [-PortNumber <Int32>]
    [-WebApplicationName <String>]
    [-WebsiteName <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

EnrollmentPoint 

Add-CMEnrollmentPoint
    [-SiteSystemServerName] <String>
    [-PortNumber <Int32>]
    [-SiteCode <String>]
    [-UserName <String>]
    [-WebApplicationName <String>]
    [-WebsiteName <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Add-CMEnrollmentPoint cmdlet adds an enrollment point to a Configuration Manager site. An enrollment point is a site system role that manages enrollment requests from mobile devices.

When Configuration Manager enrolls a mobile device, it installs a Configuration Manager client. The client provides management capabilities that include hardware inventory, software deployment, settings, and remote wipe. To enroll mobile devices, use Microsoft Certificate Services with an enterprise certification authority. You need a Configuration Manager enrollment point site system role, as well as an enrollment proxy point site system role. For more information about site system roles, see Install and Configure Site System Roles for Configuration Manager.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Add an enrollment point

PS XYZ:\>Add-CMEnrollmentPoint -SiteCode "CM4" -SiteSystemServerName "Server04.Building02.Contoso.com" -IISWebsite "Intranet17" -PortNumber 80 -UserName "QADept\Admins" -WebApplicationName "Tracker"

This command adds an enrollment point for the site that has the site code CM4 to the server named Server04.Building02.Contoso.com. The command specifies an IIS website and port number, and the user name that the enrollment point uses to connect to the Configuration Manager database. This command also specifies the web application name.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SiteServer

Parameter sets

EnrollmentPointByValue
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-PortNumber

Specifies the port to use with an enrollment point.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteCode

Specifies the site code for a Configuration Manager site.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

EnrollmentPoint
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteSystemServerName

Specifies the name of a server that hosts a site system role.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Name, ServerName

Parameter sets

EnrollmentPoint
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserName

Specifies an account that the enrollment point uses to connect to the Configuration Manager database.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

EnrollmentPoint
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WebApplicationName

Specifies the name of the web application used for enrollment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WebsiteName

The Add-CMEnrollmentPoint cmdlet adds an enrollment point to a Configuration Manager site. An enrollment point is a site system role that manages enrollment requests from mobile devices.

When Configuration Manager enrolls a mobile device, it installs a Configuration Manager client. The client provides management capabilities that include hardware inventory, software deployment, settings, and remote wipe. To enroll mobile devices, use Microsoft Certificate Services with an enterprise certification authority. You need a Configuration Manager enrollment point site system role, as well as an enrollment proxy point site system role. For more information about site system roles, see Install and Configure Site System Roles for Configuration Manager.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:IISWebsite

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject