Compartir a través de

Test-DscConfiguration

  • Referencia
Módulo:
PSDesiredStateConfiguration

Prueba si la configuración real en los nodos coincide con la configuración deseada.

Syntax

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Description

El Test-DscConfiguration cmdlet comprueba si la configuración real en los nodos coincide con la configuración deseada. Especifique los equipos para los que desea probar las configuraciones mediante nombres de equipo o sesiones de Common Information Model (CIM). Si no especifica un equipo de destino, el cmdlet prueba la configuración del equipo local.

Si las configuraciones deseadas y reales coinciden, el cmdlet devuelve un valor de cadena de "True". De lo contrario, devuelve un valor de cadena de "False".

Ejemplos

Ejemplo 1: Configuración de prueba para el equipo local

Test-DscConfiguration

Este comando prueba la configuración del equipo local.

Ejemplo 2: Configuración de prueba para un equipo especificado

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

En este ejemplo se prueba la configuración 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 $Session variable . El comando le pide una contraseña. Para obtener más información, escriba Get-Help New-CimSession.

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

Ejemplo 3: Probar configuraciones con resultados detallados

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Este comando prueba las configuraciones de un conjunto de equipos especificados por el parámetro ComputerName y devuelve información detallada que incluye el estado general, los recursos que están en estado deseado, los recursos que no están en el estado deseado y el nombre del equipo.

Ejemplo 4: Probar configuraciones especificadas en una carpeta

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Este comando prueba las configuraciones definidas en una carpeta especificada por el parámetro Path . Las configuraciones se prueban en un conjunto de equipos, cada uno identificado por el nombre de archivo del archivo de configuración.

Ejemplo 5: Probar configuraciones especificadas en un archivo

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Este comando prueba una configuración definida en un archivo en un conjunto de equipos especificados por el parámetro ComputerName .

Parámetros

-AsJob

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

Si especifica el parámetro AsJob , el comando devuelve un objeto que representa el trabajo y, a continuación, muestra el símbolo del sistema. Puede seguir trabajando en la sesión hasta que finalice el trabajo. Se crea el trabajo en el equipo local y, automáticamente, se devuelven los resultados de los equipos remotos al equipo local. Para administrar el trabajo, use los cmdlets Job. Para obtener los resultados del trabajo, use el Receive-Job cmdlet .

Para usar este parámetro, los equipos locales y remotos deben configurarse para la comunicación remota y, en Windows Vista y versiones posteriores del sistema operativo Windows, debe abrir Windows PowerShell con la opción Ejecutar como administrador. Para obtener más información, consulte about_Remote_Requirements.

Para obtener más información sobre Windows PowerShell trabajos en segundo plano, consulte about_Jobs y about_Remote_Jobs.

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[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica una matriz de nombres de equipo en los que este cmdlet prueba la configuración. El cmdlet prueba el documento de configuración en la ubicación especificada por el parámetro Path en estos equipos.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Especifica un nombre de usuario y una contraseña, como un objeto PSCredential, para el equipo de destino. Para obtener un objeto PSCredential , use el Get-Credential cmdlet . Para obtener más información, escriba Get-Help Get-Credential.

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

-Detailed

Indica que este cmdlet devuelve un resultado detallado de comparar el documento de configuración con el estado deseado de los nodos. El resultado incluye información como el estado general, los recursos que están en el estado deseado, los recursos que no están en estado deseado y el nombre del equipo.

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

-Path

Especifica la ruta de acceso de una carpeta que contiene archivos de documento de configuración. El cmdlet prueba la configuración con el estado deseado de los equipos especificados por el parámetro ComputerName o CimSession .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceConfiguration

Especifica la ruta de acceso del archivo de documento de configuración. Este cmdlet prueba la configuración con el estado real de los equipos especificados por el parámetro ComputerName o CimSession .

Type:String
Position:Named
Default value:None
Required:True
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 , Windows PowerShell calcula un límite óptimo para el cmdlet en función del número de 0 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