Stop-DscConfiguration
Arrête un travail de configuration en cours d’exécution.
Syntaxe
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 est stocké dans la variable $Session. Lorsque la commande est exécutée, vous êtes invité à entrer le mot de passe du compte d’utilisateur.
Stop-DscConfiguration utilise le paramètre CimSession et l’objet stocké dans $Session pour arrêter le travail de configuration.
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, consultez about_Remote_Requirements.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
| Type: | CimSession[] |
| Alias: | Session |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
| 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 |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
| 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
None
Sorties
None
