Remove-CMOutOfBandServicePoint
Remove-CMOutOfBandServicePoint
Removes an out-of-band service point.
Syntax
Parameter Set: SearchByNameMandatory
Remove-CMOutOfBandServicePoint -SiteCode <String> -SiteSystemServerName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Remove-CMOutOfBandServicePoint -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-CMOutOfBandServicePoint cmdlet removes an out-of-band service point from Microsoft System Center 2012 Configuration Manager. An out-of-band service point is a site system role that provisions and configures Intel Active Management Technology (AMT)-based computers for System Center 2012 Configuration Manager.
After you remove an out-of-band service point, administrative users cannot provision and configure the Intel AMT-based computers that are associated with the out-of-band service point.
Parameters
-Force
Removes the out-of-band service point without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.
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 |
-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 |
-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: Remove an out-of-band service point
This command removes the out-of-band service point from the Configuration Manager site that has the site code Cm1 on the site system server named cmcen-dist02.tsqa.contoso.com.
PS C:\> Remove-CMOutOfBandServicePoint -SiteSystemServerName "cmcen-dist02.tsqa.contoso.com" -SiteCode "Cm1"
Example 2: Remove an out-of-band service point by using an object variable
The first command gets the out-of-band service point from the Configuration Manager site that has the site code Cm1 on the site system server named cmcen-dist02.tsqa.contoso.com. The command stores the results in the $Osp variable.
The second command removes the out-of-band service point stored in the $Osp variable.
PS C:\> $Osp = Get-CMOutOfBandServicePoint -SiteSystemServerName "cmcen-dist02.tsqa.contoso.com" -SiteCode "Cm1"
PS C:\> Remove-CMOutOfBandServicePoint -InputObject $Osp