Add-CMEnrollmentProxyPoint

Adds an enrollment proxy point to Configuration Manager.

Syntax

Add-CMEnrollmentProxyPoint
   -InputObject <IResultObject>
   [-PortNumber <Int32>]
   [-ServiceHost <IResultObject>]
   [-WebsiteName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMEnrollmentProxyPoint
   [-PortNumber <Int32>]
   [-ServiceHost <IResultObject>]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-WebsiteName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-CMEnrollmentProxyPoint cmdlet adds an enrollment proxy point to a Configuration Manager site. An enrollment proxy point is a site system role.

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 (CA). You need a Configuration Manager enrollment proxy point site system role, as well as an enrollment 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 proxy point

PS XYZ:\>Add-CMEnrollmentProxyPoint -SiteCode "CM1" -SiteSystemServerName "CMEnrollmentProxyPoint.Western.Contoso.com"

This command adds an enrollment proxy point for the Configuration Manager site that has the site code CM1. The specified computer hosts the role.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Aliases:SiteServer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PortNumber

Specifies the port that client computers use to connect with an enrollment proxy point.

Type:Int32
Aliases:Port
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceHost

Type:IResultObject
Aliases:EnrollmentPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Specifies the site code for a Configuration Manager site.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteSystemServerName

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

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WebsiteName

Type:String
Aliases:IISWebsite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject