Get-DscConfiguration

  • Referencia
Módulo:
PSDesiredStateConfiguration

Obtiene la configuración actual de los nodos.

Syntax

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

Description

El Get-DscConfiguration cmdlet obtiene la configuración actual de los nodos, si la configuración existe. Especifique los equipos usando sesiones del Modelo de información común (CIM). Si no especifica un equipo de destino, el cmdlet obtiene la configuración del equipo local.

Ejemplos

Ejemplo 1: Obtención de la configuración del equipo local

Get-DscConfiguration

Este comando obtiene el estado actual del equipo local.

Ejemplo 2: Obtener la configuración de un equipo especificado

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

En este ejemplo se obtiene el estado actual de un equipo especificado por una sesión CIM. En el ejemplo se crea una sesión CIM para un equipo denominado Server01 para su uso con el cmdlet . También puede crear una matriz de sesiones CIM para aplicar el cmdlet a varios equipos especificados.

El primer comando crea una sesión CIM mediante el New-CimSession cmdlet y, a continuación, almacena el objeto CimSession en la variable $Session . El comando le pide una contraseña. Para obtener más información, escriba Get-Help New-CimSession.

El segundo comando obtiene la configuración actual de los equipos identificados por los objetos CimSession almacenados en la variable $Session, en este caso, el equipo llamado Server01.

Parámetros

-AsJob

Indica que este cmdlet ejecuta el comando como un trabajo en segundo plano.

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

-CimSession

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession . El valor predeterminado es la sesión actual en el equipo local.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o se especifica un valor de 0 , Windows PowerShell calcula un límite óptimo para el cmdlet en función del número de cmdlets CIM que se ejecutan en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

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