Set-CMOutOfBandServicePoint
Set-CMOutOfBandServicePoint
Changes configuration settings for an out of band service point.
Syntax
Parameter Set: SetByName
Set-CMOutOfBandServicePoint -SiteCode <String> -SiteSystemServerName <String> [-EnableCrlChecking <Boolean> ] [-ErrorRetryCount <Int32> ] [-ErrorRetryMinutesDelay <Int32> ] [-ProvisioningCertificateThumbprint <String> ] [-TransmissionStartMinutesInterval <Int32> ] [-TransmissionThreadCount <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValue
Set-CMOutOfBandServicePoint -InputObject <IResultObject> [-EnableCrlChecking <Boolean> ] [-ErrorRetryCount <Int32> ] [-ErrorRetryMinutesDelay <Int32> ] [-ProvisioningCertificateThumbprint <String> ] [-TransmissionStartMinutesInterval <Int32> ] [-TransmissionThreadCount <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMOutOfBandServicePoint cmdlet changes configuration settings for an out of band service point. An out of band service point is a site system role that provisions and configures Intel Active Management Technology (AMT)-based computers for Microsoft System Center 2012 SP1 Configuration Manager.
Parameters
-EnableCrlChecking<Boolean>
Indicates whether the out of band service point verifies the certificate revocation list (CRL) for the provisioning certificate.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ErrorRetryCount<Int32>
Specifies the number of retry attempts that Configuration Manager makes after it fails to turn on an AMT-based computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ErrorRetryMinutesDelay<Int32>
Specifies the number of minutes that Configuration Manager waits between retry attempts to turn on an AMT-based computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InputObject<IResultObject>
Specifies a CMOutOfBandServicePoint object. To obtain a CMOutOfBandServicePoint object, use the Get-CMOutOfBandServicePoint cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ProvisioningCertificateThumbprint<String>
Specifies the thumbprint of the AMT provisioning certificate.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteCode<String>
Specifies the site code of the Configuration Manager site that hosts the site system role.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteSystemServerName<String>
Specifies a 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 |
-TransmissionStartMinutesInterval<Int32>
Specifies the time, in minutes, that Configuration Manager sends commands to turn on an AMT-based computer before a scheduled wake-up activity.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TransmissionThreadCount<Int32>
Specifies the maximum number of connection threads that the site system role supports.
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: Change settings of an out of band service point
This command changes the settings of the out of band service point from the System Center 2012 Configuration Manager site that has the site code named CM2 on the site system named cmcen-dist02.tsqa.contoso.com.
PS C:\> Set-CMOutOfBandServicePoint -SiteSystemServerName "cmcen-dist02.tsqa.contoso.com" -SiteCode "CM2" -ErrorRetryMinutesDelay 1 -TransmissionThreadCount 1 -TransmissionStartMinutesInterval 1 -EnableCrlChecking 1 -ProvisioningCertificateThumbprint "916EC36F1068D47DE48A02A788A9DB137CD0B674"
Example 2: Change settings of an out of band service point by using an object variable
The first command gets the out of band service point from the System Center 2012 Configuration Manager site that has the site code named CM2 on the site system named cmcen-dist02.tsqa.contoso.com. The command stores the results in the $Osp variable.
The second command changes the settings of the out of band service point stored in the $Osp variable.
PS C:\> $Osp = Get-CMOutOfBandServicePoint -SiteSystemServerName "cmcen-dist02.tsqa.contoso.com" -SiteCode "CM2"
PS C:\> Set-CMOutOfBandServicePoint -InputObject $Osp -ErrorRetryCount 1 -ErrorRetryMinutesDelay 1 -TransmissionThreadCount 1 -TransmissionStartMinutesInterval 1 -EnableCrlChecking 1 -ProvisioningCertificateThumbprint "916EC36F1068D47DE48A02A788A9DB137CD0B674"