Compartir a través de

Start-DscConfiguration

  • Referencia
Módulo:
PSDesiredStateConfiguration

Aplica la configuración a los nodos.

Sintaxis

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

El cmdlet Start-DscConfiguration aplica la configuración a los nodos. Cuando se usa con el parámetro UseExisting, se aplica la configuración existente en el equipo de destino. Especifique los equipos a los que desea aplicar la configuración especificando nombres de equipo o mediante sesiones de Common Information Model (CIM).

De forma predeterminada, este cmdlet crea un trabajo y devuelve un objeto Job. Para obtener más información sobre los trabajos en segundo plano, escriba Get-Help about_Jobs. Para usar este cmdlet de forma interactiva, especifique el parámetro wait wait.

Especifique el parámetro verbose para ver los detalles de lo que hace el cmdlet cuando aplica las opciones de configuración.

Ejemplos

Ejemplo 1: Aplicar opciones de configuración

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Este comando aplica las opciones de configuración de C:\DSC\Configurations\ a todos los equipos que tienen valores en esa carpeta. El comando devuelve objetos job para cada nodo de destino implementado.

Ejemplo 2: Aplicar opciones de configuración y esperar a que se complete la configuración

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Este comando aplica la configuración de C:\DSC\Configurations\ al equipo local. El comando devuelve objetos Job para cada nodo de destino implementado en, en este caso, solo el equipo local. En este ejemplo se especifica el parámetro detallado de. Por lo tanto, el comando envía mensajes a la consola a medida que continúa. El comando incluye el parámetro Wait. Por lo tanto, no puede usar la consola hasta que el comando finalice todas las tareas de configuración.

Ejemplo 3: Aplicar opciones de configuración mediante una sesión CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

En este ejemplo se aplican las opciones de configuración a un equipo especificado. En el ejemplo se crea una sesión CIM para un equipo denominado Server01 para su uso con el cmdlet . Como alternativa, cree una matriz de sesiones CIM para aplicar el cmdlet a varios equipos especificados.

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

El segundo comando aplica las opciones de configuración de C:\DSC\Configurations a los equipos identificados por los objetos CimSession almacenados en la variable $Session. En este ejemplo, la variable $Session contiene una sesión CIM solo para el equipo denominado Server01. El comando aplica la configuración. El comando crea objetos job para cada equipo configurado.

Parámetros

-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 New-CimSession o cmdlet get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Tipo:CimSession[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ComputerName

Especifica una matriz de nombres de equipo. Este parámetro restringe los equipos que tienen documentos de configuración en el parámetro Path a los especificados en la matriz.

Tipo:String[]
Alias:CN, ServerName
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

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

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Detiene la operación de configuración que se ejecuta actualmente en el equipo de destino y comienza la nueva operación de Start-Configuration. Si el RefreshMode del Administrador de configuración local se establece en Pull, especificando este parámetro cambia a Push.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobName

Especifica un nombre descriptivo para un trabajo. Si especifica este parámetro, el cmdlet se ejecuta como un trabajo y devuelve un objeto Job.

De forma predeterminada, Windows PowerShell asigna el nombre JobN donde N es un entero.

Si especifica el parámetro Wait, no especifique este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica una ruta de acceso de archivo de una carpeta que contiene archivos de configuración. Este cmdlet publica y aplica estas opciones de configuración a los equipos que tienen archivos de configuración en la ruta de acceso especificada. Cada nodo de destino debe tener un archivo de configuración con el siguiente formato: <NetBIOS Name>.mof.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 o al equipo.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UseExisting

Indica que este cmdlet aplica la configuración existente. La configuración puede existir en el equipo de destino mediante Start-DscConfiguration o publicación mediante el cmdlet Publish-DscConfiguration.

Antes de especificar este parámetro para este cmdlet, revise la información de Novedades de Windows PowerShell 5.0.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Wait

Indica que el cmdlet bloquea la consola hasta que finaliza todas las tareas de configuración.

Si especifica este parámetro, no especifique el parámetro JobName.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False