Freigeben über


Clear-CMPxeDeployment

Löscht den Status der letzten PXE-Bereitstellung in Configuration Manager.

Syntax

Clear-CMPxeDeployment
     -DeviceCollection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -Device <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -DeviceCollectionId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -DeviceCollectionName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -DeviceName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -ResourceId <Int32[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet Clear-CMPxeDeployment löscht den Status der letzten PXE-Bereitstellung (Pre-Boot EXecution Environment) in Configuration Manager.

Sie können eine erforderliche PXE-Bereitstellung für eine Sammlung von Geräten erneut bereitstellen. Löschen Sie den Status der letzten PXE-Bereitstellung, die dieser Configuration Manager-Sammlung zugewiesen wurde. Configuration Manager stellt die zuletzt erforderlichen Bereitstellungen erneut bereit.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Löschen einer PXE-Bereitstellung für eine Gerätesammlung

PS XYZ:\>Clear-CMPxeDeployment -DeviceCollectionId "SMS00072"

Dieser Befehl löscht eine PXE-Bereitstellung, die mit einer Gerätesammlungs-ID identifiziert wird.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Device

Gibt ein Geräteobjekt an. Verwenden Sie zum Abrufen eines Geräteobjekts das Cmdlet Get-CMDevice .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DeviceCollection

Gibt ein Gerätesammlungsobjekt an. Verwenden Sie das Cmdlet Get-CMDeviceCollection , um ein Gerätesammlungsobjekt abzurufen.

Typ:IResultObject
Aliase:Collection
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DeviceCollectionId

Gibt ein Array von IDs von Gerätesammlungen an.

Typ:String[]
Aliase:CollectionId, DeviceCollectionIds, CollectionIds
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceCollectionName

Gibt ein Array von Namen von Gerätesammlungen an.

Typ:String[]
Aliase:CollectionName, DeviceCollectionNames, CollectionNames
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceName

Gibt ein Array von Gerätenamen an.

Typ:String[]
Aliase:DeviceNames
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceId

Gibt ein Array von IDs für Ressourcen an. Das Cmdlet löscht den Status der PXE-Bereitstellung für diese Ressourcen.

Typ:Int32[]
Aliase:ResourceIds
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object