Remove-CMAmtProvisioningData
Remove-CMAmtProvisioningData
Removes provisioning information for an Intel AMT computer.
Syntax
Parameter Set: SearchByNameMandatory
Remove-CMAmtProvisioningData -ControlType <RemoteControlType> {FullUnprovision | FullUnprovisionSuppressAuto | KerberosFullUnprovision | KerberosFullUnprovisionSuppressAuto | KerberosPartialUnprovision | KerberosPartialUnprovisionSuppressAuto | PartialUnprovision | PartialUnprovisionSuppressAuto} -DeviceName <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByIdMandatory
Remove-CMAmtProvisioningData -ControlType <RemoteControlType> {FullUnprovision | FullUnprovisionSuppressAuto | KerberosFullUnprovision | KerberosFullUnprovisionSuppressAuto | KerberosPartialUnprovision | KerberosPartialUnprovisionSuppressAuto | PartialUnprovision | PartialUnprovisionSuppressAuto} -DeviceId <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Remove-CMAmtProvisioningData -ControlType <RemoteControlType> {FullUnprovision | FullUnprovisionSuppressAuto | KerberosFullUnprovision | KerberosFullUnprovisionSuppressAuto | KerberosPartialUnprovision | KerberosPartialUnprovisionSuppressAuto | PartialUnprovision | PartialUnprovisionSuppressAuto} -Device <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-CMAmtProvisioningData cmdlet removes the Microsoft System Center 2012 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 2012 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 2012 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.
Parameters
-ControlType<RemoteControlType>
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.
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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Device<IResultObject>
Specifies a device object. To obtain a device object, use the Get-CMDevice cmdlet.
Aliases |
InputObject |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceId<String[]>
Specifies an array of IDs of devices.
Aliases |
ResourceId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceName<String[]>
Specifies an array of names of devices.
Aliases |
Name |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Performs the action without a confirmation message.
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: Remove provisioning information completely for a specified computer
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 uses the Force parameter. Therefore, it does not prompt you for confirmation.
PS C:\> Remove-CMAmtProvisioningData -ControlType FullUnprovisionSuppressAuto -DeviceId "SMS000076" -Force