Share via

Get-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Obtient la configuration actuelle des nœuds.

Syntax

Get-DscConfiguration
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

L’applet Get-DscConfiguration de commande obtient la configuration actuelle des nœuds, si la configuration existe. Spécifiez les ordinateurs à l'aide de sessions CIM (Common Information Model). Si vous ne spécifiez pas d'ordinateur cible, l'applet de commande obtient la configuration de l'ordinateur local.

Exemples

Exemple 1 : Obtenir la configuration de l’ordinateur local

Get-DscConfiguration

Cette commande obtient l’état actuel de l’ordinateur local.

Exemple 2 : Obtenir la configuration d’un ordinateur spécifié

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-DscConfiguration -CimSession $Session

Cet exemple obtient l’état actuel à partir d’un ordinateur spécifié par une session CIM. L'exemple crée une session CIM pour un ordinateur nommé Server01 à utiliser avec l'applet de commande. Vous pouvez aussi créer un tableau de sessions CIM pour appliquer l'applet de commande à plusieurs ordinateurs spécifiés.

La première commande crée une session CIM à l’aide de l’applet New-CimSession de commande, puis stocke l’objet CimSession dans la variable $Session . La commande vous invite à entrer un mot de passe. Pour plus d'informations, voir Get-Help New-CimSession.

La deuxième commande obtient la configuration actuelle des ordinateurs identifiés par les objets CimSession stockés dans la variable $Session (dans ce cas, l'ordinateur nommé Server01).

Paramètres

-AsJob

Indique que cette applet de commande exécute la commande en tant que travail en arrière-plan.

Type:SwitchParameter
Position:Named
Default value:None
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 d’une applet de commande New-CimSession ou Get-CimSession . La valeur par défaut est la session active sur l’ordinateur local.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
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 si une valeur de 0 est entrée, Windows PowerShell calcule une limite de limitation optimale pour l’applet de commande 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