Clear-CMPxeDeployment

Cancella lo stato della distribuzione PXE più recente in Configuration Manager.

Sintassi

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>]

Descrizione

Il cmdlet Clear-CMPxeDeployment cancella lo stato della distribuzione PXE (Pre-Boot EXecution Environment) più recente in Configuration Manager.

Puoi ridistribuire una distribuzione PXE necessaria per una raccolta di dispositivi. Cancella lo stato dell'ultima distribuzione PXE assegnata a tale raccolta di Configuration Manager. Configuration Manager ridistribuisce le distribuzioni necessarie più recenti.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: cancellare una distribuzione PXE per una raccolta di dispositivi

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

Questo comando cancella una distribuzione PXE identificata con un ID raccolta dispositivi.

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-Device

Specifica un oggetto dispositivo. Per ottenere un oggetto dispositivo, utilizzare il cmdlet Get-CMDevice.

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

-DeviceCollection

Specifica un oggetto insieme di dispositivi. Per ottenere un oggetto insieme di dispositivi, utilizzare il cmdlet Get-CMDeviceCollection.

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

-DeviceCollectionId

Specifica una matrice di ID di raccolte di dispositivi.

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

-DeviceCollectionName

Specifica una matrice di nomi di raccolte di dispositivi.

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

-DeviceName

Specifica una matrice di nomi di dispositivi.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-ResourceId

Specifica una matrice di ID per le risorse. Il cmdlet cancella lo stato della distribuzione PXE per queste risorse.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object