Remove-CMDeviceCollectionVariable
Supprimez une variable de regroupement d’appareils.
Syntax
Remove-CMDeviceCollectionVariable
-Collection <IResultObject>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionVariable
-CollectionId <String>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionVariable
-CollectionName <String>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette applet de commande pour supprimer une variable de regroupement d’appareils.
Les collections par défaut ne peuvent pas avoir de variables. Toute collection que vous ciblez doit avoir un ID qui commence par le code de site, et non SMS
.
Pour plus d’informations, consultez Guide pratique pour définir des variables de séquence de tâches.
Remarque
Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>
. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Supprimer une variable de regroupement d’appareils
La première commande obtient l’objet de collection d’appareils nommé Device et le stocke dans la variable $Collection .
La deuxième commande supprime la variable de collecte d’appareils nommée testTS de la collection d’appareils stockée dans la variable $Collection . La spécification du paramètre Force indique que vous n’êtes pas invité avant la suppression de la variable.
$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force
Exemple 2 : Supprimer toutes les variables d’un regroupement d’appareils
Cet exemple utilise d’abord l’applet de commande Get-CMDeviceCollectionVariable pour obtenir toutes les variables sur les serveurs informatiques du regroupement d’appareils et stocke les objets dans la variable de tableau vars . Il effectue ensuite une boucle dans chaque élément du tableau et supprime la variable par nom.
Le paramètre Force est utilisé pour que vous ne soyez pas invité à supprimer chaque variable.
$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName
foreach ( $var in $vars ) {
Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}
Étant donné que le paramètre VariableName n’autorise pas les caractères génériques, utilisez ce processus si vous devez effacer rapidement toutes les variables d’un regroupement d’appareils.
Paramètres
-Collection
Spécifiez un objet de collection d’appareils pour supprimer ses variables. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection ou Get-CMDeviceCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CollectionId
Spécifiez l’ID d’un regroupement d’appareils pour supprimer ses variables. Cette valeur est la propriété CollectionID, par exemple . XYZ00012
Étant donné que vous ne pouvez pas définir de variables sur des collections par défaut, cette valeur commence par le code de site, et non SMS
par .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Spécifiez le nom d’un regroupement d’appareils pour supprimer ses variables.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariableName
Spécifiez le nom d’une variable de collection à supprimer. Ce paramètre n’accepte pas les caractères génériques.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour