Stop-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Arrête un travail de configuration en cours d’exécution.

Syntax

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet Stop-DscConfiguration de commande 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). Si aucun travail de configuration n’est en cours d’exécution, cette applet de commande renvoie un message d’avertissement.

Stop-DscConfigurationest disponible uniquement dans le cadre du correctif cumulatif de novembre 2014 pour Windows RT 8.1, Windows 8.1 et Windows Server 2012 R2 à partir de la bibliothèque Support Microsoft. Avant d’utiliser cette applet de commande, passez en revue les informations dans 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 New-CimSession commande . 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 $Session variable . 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
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Exécute l’applet de commande dans une session à distance 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[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Stop-DscConfiguration ne prend pas en charge le paramètre Confirm . Si le paramètre Confirm est utilisé, une erreur s’affiche.

Pour les applets de commande PowerShell qui prennent en charge Confirm, l’utilisation du paramètre vous invite à effectuer une vérification avant l’exécution d’une commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Spécifie le nombre maximal d’opérations simultanées pouvant être établi pour exécuter l’applet de commande.

Si ce paramètre est omis ou qu’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. Le seuil de limitation s’applique uniquement à l’applet de commande active et non à la session ou à l’ordinateur.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Sorties

None