Stop-DscConfiguration
Arrête un travail de configuration en cours d’exécution.
Syntaxe
All
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Stop-DscConfiguration arrête un travail de configuration en cours d’exécution. Spécifiez les ordinateurs auxquels cette applet de commande s’applique à l’aide de sessions CIM (Common Information Model). S’il n’y a pas de travail de configuration en cours d’exécution, cette applet de commande retourne un message d’avertissement.
Stop-DscConfiguration est disponible uniquement dans le cadre du correctif cumulatif novembre 2014 pour Windows RT 8.1, Windows 8.1 et Windows Server 2012 R2 à partir de la bibliothèque de support Microsoft. Avant d’utiliser cette applet de commande, passez en revue les informations de Nouveautés de Windows PowerShell 5.0
Exemples
Exemple 1 : Arrêter un travail de configuration
Dans cet exemple, une session CIM est créée à l’aide de l’applet de commande New-CimSession. L’objet CimSession est utilisé pour arrêter un travail de configuration en cours d’exécution.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession utilise le paramètre ComputerName pour spécifier l’ordinateur Server01. Le paramètre Credential spécifie le compte d’utilisateur. L’objet CimSession
Paramètres
-AsJob
Indique que cette applet de commande exécute la commande en tant que travail en arrière-plan. Pour plus d’informations sur les travaux en arrière-plan PowerShell, consultez about_Jobs et about_Remote_Jobs.
Pour utiliser le paramètre AsJob, les ordinateurs locaux et distants doivent être configurés pour la communication à distance. Sur Windows Vista et les versions ultérieures du système d’exploitation Windows, vous devez ouvrir PowerShell avec l’option Exécuter en tant qu’administrateur. Pour plus d'informations, voir about_Remote_Requirements.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CimSession
Exécute l’applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, tel que la sortie de New-CimSession ou Get-CimSession.
Propriétés du paramètre
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | session |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Stop-DscConfiguration ne prend pas en charge le paramètre Confirmer. Si le paramètre Confirmer est utilisé, une erreur s’affiche.
Pour les applets de commande PowerShell qui prennent en charge Confirmer, l’utilisation du paramètre vous invite à vérifier avant l’exécution d’une commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ThrottleLimit
Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter l’applet de commande.
Si ce paramètre est omis ou si une valeur de 0 est entrée, PowerShell calcule une limite de limitation optimale en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limite de limitation s’applique uniquement à l’applet de commande actuelle, et non à la session ou à l’ordinateur.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
