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-Auflistung zugewiesen wurde. Configuration Manager legt die neuesten erforderlichen Bereitstellungen erneut bereit.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. 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"

Mit diesem Befehl wird eine PXE-Bereitstellung gelöscht, die mit einer Gerätesammlungs-ID identifiziert wurde.

Parameter

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Device

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DeviceCollection

Gibt ein Gerätesammlungsobjekt an. Verwenden Sie zum Abrufen eines Gerätesammlungsobjekts das Cmdlet "Get-CMDeviceCollection".

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DeviceCollectionId

Gibt ein Array von IDs von Gerätesammlungen an.

Type:String[]
Aliases:CollectionId, DeviceCollectionIds, CollectionIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceCollectionName

Gibt ein Array von Namen von Gerätesammlungen an.

Type:String[]
Aliases:CollectionName, DeviceCollectionNames, CollectionNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

Gibt ein Array von Namen von Geräten an.

Type:String[]
Aliases:DeviceNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

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

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

-ResourceId

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

Type:Int32[]
Aliases:ResourceIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object