Set-CMOutOfBandServicePoint

Changes configuration settings for an out of band service point.

Syntax

Set-CMOutOfBandServicePoint
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableCrlChecking <Boolean>]
   [-ErrorRetryCount <Int32>]
   [-ErrorRetryMinutesDelay <Int32>]
   [-ForceWildcardHandling]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProvisioningCertificateThumbprint <String>]
   [-TransmissionStartMins <Int32>]
   [-TransmissionThreadCount <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMOutOfBandServicePoint [-SiteSystemServerName]  [-Confirm] [-DisableWildcardHandling]
 [-EnableCrlChecking ] [-ErrorRetryCount ] [-ErrorRetryMinutesDelay ]
 [-ForceWildcardHandling] [-PassThru] [-ProvisioningCertificateThumbprint ] [-SiteCode ]
 [-TransmissionStartMins ] [-TransmissionThreadCount ] [-WhatIf] []

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 Configuration Manager.

Examples

Example 1: Change settings of an out of band service point

PS C:\> Set-CMOutOfBandServicePoint -SiteSystemServerName "cmcen-dist02.tsqa.contoso.com" -SiteCode "CM2" -ErrorRetryMinutesDelay 1 -TransmissionThreadCount 1 -TransmissionStartMinutesInterval 1 -EnableCrlChecking 1 -ProvisioningCertificateThumbprint "916EC36F1068D47DE48A02A788A9DB137CD0B674"

This command changes the settings of the out of band service point from the System Center Configuration Manager site that has the site code named CM2 on the site system named cmcen-dist02.tsqa.contoso.com.

Example 2: Change settings of an out of band service point by using an object 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"

The first command gets the out of band service point from the System Center 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.

Required Parameters

-InputObject

Specifies a CMOutOfBandServicePoint object. To obtain a CMOutOfBandServicePoint object, use the Get-CMOutOfBandServicePoint cmdlet.

Type:IResultObject
Aliases:OutOfBandServicePoint
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SiteSystemServerName

Specifies a fully qualified domain name (FQDN) of the server that hosts the site system role.

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

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

Indicates that wildcard handling is disabled.

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

Indicates whether the out of band service point verifies the certificate revocation list (CRL) for the provisioning certificate.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ErrorRetryCount

Specifies the number of retry attempts that Configuration Manager makes after it fails to turn on an AMT-based computer.

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

Specifies the number of minutes that Configuration Manager waits between retry attempts to turn on an AMT-based computer.

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

Indicates that wildcard handling is enabled.

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

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

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

Specifies the thumbprint of the AMT provisioning certificate.

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

Specifies the site code of the Configuration Manager site that hosts the site system role.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TransmissionStartMins
Type:Int32
Aliases:ThreadsOffset, TransmissionStartMinutesInterval
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TransmissionThreadCount

Specifies the maximum number of connection threads that the site system role supports.

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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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