Remove-CMAmtProvisioningData

Removes provisioning information for an Intel AMT computer.

Syntax

Remove-CMAmtProvisioningData
      -Device <IResultObject>
      -ControlType <RemoteControlType>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAmtProvisioningData
      -DeviceId <String>
      -ControlType <RemoteControlType>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAmtProvisioningData
      -DeviceName <String>
      -ControlType <RemoteControlType>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-CMAmtProvisioningData cmdlet removes the Microsoft System Center Configuration Manager provisioning information for an Intel Active Management Technology (Intel AMT)-based computer. You might want to remove provisioning information when you no longer want to manage a computer out of band by using System Center Configuration Manager.

You can either remove all configuration data or retain identification information about the computer, such as its host name, IP address, and DNS suffix.

By default, System Center Configuration Manager automatically reprovisions Intel AMT-based computers if you have configured Intel AMT provisioning. Use the ControlType parameter to control reprovisioning for individual computers.

Examples

Example 1: Remove provisioning information completely for a specified computer

PS C:\> Remove-CMAmtProvisioningData -ControlType FullUnprovisionSuppressAuto -DeviceId "SMS000076" -Force

This command removes provisioning information from a computer that has the ID SMS000076. The cmdlet removes all provisioning data and suppresses automatic reprovisioning. The command specifies the Force parameter. Therefore, it does not prompt you for confirmation.

Required Parameters

-ControlType

Specifies how Configuration Manager removes provisioning information. This parameter controls whether the cmdlet removes some or all provisioning information. This parameter also determines whether the cmdlet allows Configuration Manager to reprovision an Intel AMT-based computer later.

The acceptable values for this parameter are:

  • FullUnprovision. Resets Intel AMT to the factory default settings.
  • FullUnprovisionSuppressAuto. Resets Intel AMT to the factory default settings and does not allow Configuration Manager to reprovision the computer.
  • KerberosFullUnprovision. Resets Intel AMT for Kerberos-enabled computers to factory default settings.
  • KerberosFullUnprovisionSuppressAuto. Resets Intel AMT for Kerberos-enabled computers to factory default settings, and does not allow Configuration Manager to reprovision the computer.
  • KerberosPartialUnprovision. Resets Intel AMT for Kerberos-enabled computers except for identification information about the computer.
  • KerberosPartialUnprovisionSuppressAuto. Resets Intel AMT for Kerberos-enabled computers except for identification information about the computer, and does not allow Configuration Manager to reprovision the computer.
  • PartialUnprovision. Resets Intel AMT to the factory default settings, except for identification information about the computer.
  • PartialUnprovisionSuppressAuto. Resets Intel AMT to the factory default settings, except for identification information about the computer, and does not allow Configuration Manager to reprovision the computer.
Type:RemoteControlType
Parameter Sets:DiscoveryBmc, PartialUnprovision, FullUnprovision, FullUnprovisionSuppressAuto, PartialUnprovisionSuppressAuto, KerberosFullUnprovision, KerberosFullUnprovisionSuppressAuto, KerberosPartialUnprovision, KerberosPartialUnprovisionSuppressAuto, Unsuppress, EnableAudit, DisableAudit, ClearAuditLog
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Device

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

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

Specifies an array of IDs of devices.

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceName

Specifies an array of names of devices.

Type:String
Aliases:Name
Position:Named
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
-Force

Forces the command to run without asking for user confirmation.

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

Indicates that wildcard handling is enabled.

The acceptable values for this parameter are:

  • FullUnprovision. Resets Intel AMT to the factory default settings.
  • FullUnprovisionSuppressAuto. Resets Intel AMT to the factory default settings and does not allow Configuration Manager to reprovision the computer.
  • KerberosFullUnprovision. Resets Intel AMT for Kerberos-enabled computers to factory default settings.
  • KerberosFullUnprovisionSuppressAuto. Resets Intel AMT for Kerberos-enabled computers to factory default settings, and does not allow Configuration Manager to reprovision the computer.
  • KerberosPartialUnprovision. Resets Intel AMT for Kerberos-enabled computers except for identification information about the computer.
  • KerberosPartialUnprovisionSuppressAuto. Resets Intel AMT for Kerberos-enabled computers except for identification information about the computer, and does not allow Configuration Manager to reprovision the computer.
  • PartialUnprovision. Resets Intel AMT to the factory default settings, except for identification information about the computer.
  • PartialUnprovisionSuppressAuto. Resets Intel AMT to the factory default settings, except for identification information about the computer, and does not allow Configuration Manager to reprovision the computer.
Type:SwitchParameter
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