Compartir a través de

Set-DscLocalConfigurationManager

  • Referencia
Módulo:
PSDesiredStateConfiguration

Aplica la configuración del Administrador de configuración local (LCM) a los nodos.

Sintaxis

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-DscLocalConfigurationManager aplica la configuración de LCM o la metaconfiguración a los nodos. Especifique los equipos especificando nombres de equipo o mediante sesiones de Common Information Model (CIM). Si no especifica un equipo de destino, el cmdlet aplica la configuración al equipo local.

Ejemplos

Ejemplo 1: Aplicar la configuración de LCM

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Este comando aplica la configuración de LCM de C:\DSC\Configurations\ a los nodos de destino. Después de recibir la configuración, LCM los procesa.

Advertencia

Si hay varios meta mofs para el mismo equipo almacenado en la carpeta especificada, solo se aplicará el primer meta mof.

Ejemplo 2: Aplicar la configuración de LCM mediante una sesión CIM

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

En este ejemplo se aplica la configuración de LCM a un equipo y se aplica la configuración. 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 New-CimSession.

El segundo comando aplica la configuración de LCM para el nodo de destino desde C:\DSC\Configurations\ al equipo identificado 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. Después de recibir la configuración, LCM los procesa.

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 metaconfiguració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

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
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. El cmdlet publica y aplica esta configuración de LCM 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.meta.mof.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
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

-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