Clear-CMPxeDeployment
Efface l’état du déploiement PXE le plus récent dans Configuration Manager.
Syntaxe
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>] Description
L’applet de commande Clear-CMPxeDeployment efface l’état du déploiement PXE (Pre-Boot EXecution Environment) le plus récent dans Configuration Manager.
Vous pouvez redéployer un déploiement PXE requis pour un ensemble d’appareils. Effacez l’état du dernier déploiement PXE affecté à ce regroupement Configuration Manager. Configuration Manager redéploie les déploiements requis les plus récents.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Effacer un déploiement PXE pour un regroupement d’appareils
PS XYZ:\>Clear-CMPxeDeployment -DeviceCollectionId "SMS00072"Cette commande efface un déploiement PXE identifié avec un ID de regroupement d’appareils.
Paramètres
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Device
Spécifie un objet d’appareil. Pour obtenir un objet d’appareil, utilisez l’applet de commande Get-CMDevice .
| Type: | IResultObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DeviceCollection
Spécifie un objet de collection d’appareils. Pour obtenir un objet de collection d’appareils, utilisez l’applet de commande Get-CMDeviceCollection .
| Type: | IResultObject |
| Alias: | Collection |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DeviceCollectionId
Spécifie un tableau d’ID de regroupements d’appareils.
| Type: | String[] |
| Alias: | CollectionId, DeviceCollectionIds, CollectionIds |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeviceCollectionName
Spécifie un tableau de noms de regroupements d’appareils.
| Type: | String[] |
| Alias: | CollectionName, DeviceCollectionNames, CollectionNames |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeviceName
Spécifie un tableau de noms d’appareils.
| Type: | String[] |
| Alias: | DeviceNames |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ResourceId
Spécifie un tableau d’ID pour les ressources. L’applet de commande efface l’état du déploiement PXE pour ces ressources.
| Type: | Int32[] |
| Alias: | ResourceIds |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object