Set-​CM​Out​Of​Band​Service​Point

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] <String>
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableCrlChecking <Boolean>]
   [-ErrorRetryCount <Int32>]
   [-ErrorRetryMinutesDelay <Int32>]
   [-ForceWildcardHandling]
   [-PassThru]
   [-ProvisioningCertificateThumbprint <String>]
   [-SiteCode <String>]
   [-TransmissionStartMins <Int32>]
   [-TransmissionThreadCount <Int32>]
   [-WhatIf]
   [<CommonParameters>]

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
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
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
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
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
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProvisioningCertificateThumbprint

Specifies the thumbprint of the AMT provisioning certificate.

Type:String
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TransmissionStartMins
Type:Int32
Aliases:ThreadsOffset, TransmissionStartMinutesInterval
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
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False