Set-CMEnrollmentPoint
Set-CMEnrollmentPoint
Sets an enrollment point in Configuration Manager.
Syntax
Parameter Set: SetByName
Set-CMEnrollmentPoint -SiteCode <String> -SiteSystemServerName <String> [-UseComputerAccount] [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValue
Set-CMEnrollmentPoint -InputObject <IResultObject> [-UseComputerAccount] [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMEnrollmentPoint cmdlet sets an enrollment point in Microsoft System Center 2012 SP1 Configuration Manager. An enrollment point is a site system role that uses public key infrastructure (PKI) certificates to complete mobile device enrollment and to provision Intel AMT-based computers.
Parameters
-InputObject<IResultObject>
Specifies an input object. To get an input object, use the Get-CMEnrollmentPoint cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteCode<String>
Specifies the site code for a Configuration Manager site.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteSystemServerName<String>
Specifies the fully qualified domain name (FQDN) of the server that hosts the site system role.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UseComputerAccount
Indicates that you use the computer account to connect to the Configuration Manager database.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UserName<String>
Specifies a user account that the enrollment point uses to connect to the Configuration Manager database.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
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, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Set an enrollment point
The command sets an enrollment point, and specifies an account name to use to connect to the Configuration Manager database.
PS C:\> Set-CMEnrollmentPoint -SiteSystemServerName "CM-Contoso.Contoso.Com" -SiteCode "CM2" -UserName "Contoso\ElisaDaugherty"
Example 2: Set an enrollment point with the computer account
The command sets an enrollment point by specifying the site system server and site code, and uses the computer account to connect to the Configuration Manager database.
PS C:\> Set-CMEnrollmentPoint -SiteSystemServerName "CM-Contoso.Contoso.Com" -SiteCode "CM2" -UseComputerAccount
Example 3: Set an enrollment point by using an input object
The first command uses the Get-CMEnrollmentPoint cmdlet to get an enrollment point, and stores the result in the $Ep variable.
The second command sets an enrollment point for a server by using the input object stored in the $Ep variable.
PS C:\> $Ep = Get-CMEnrollmentPoint -SiteSystemServerName "CM-Contoso.Contoso.Com" -SiteCode "CM2"
PS C:\> Set-CMEnrollmentPoint -InputObject $Ep -UserName "Contoso\ElisaDaugherty"