Condividi tramite


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.

È possibile ridistribuire una distribuzione PXE necessaria per una raccolta di dispositivi. Cancellare lo stato dell'ultima distribuzione PXE assegnata a tale raccolta di Configuration Manager. Configuration Manager ridistribuisce le distribuzioni richieste più recenti.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre 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 di dispositivi.

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Device

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

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DeviceCollection

Specifica un oggetto raccolta di dispositivi. Per ottenere un oggetto raccolta di dispositivi, usare il cmdlet Get-CMDeviceCollection .

Tipo:IResultObject
Alias:Collection
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DeviceCollectionId

Specifica una matrice di ID delle raccolte di dispositivi.

Tipo:String[]
Alias:CollectionId, DeviceCollectionIds, CollectionIds
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceCollectionName

Specifica una matrice di nomi di raccolte di dispositivi.

Tipo:String[]
Alias:CollectionName, DeviceCollectionNames, CollectionNames
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceName

Specifica una matrice di nomi di dispositivi.

Tipo:String[]
Alias:DeviceNames
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceId

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

Tipo:Int32[]
Alias:ResourceIds
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object