Compartir a través de

Update-DscConfiguration

  • Referencia
Módulo:
PSDesiredStateConfiguration

Comprueba el servidor de extracción para obtener una configuración actualizada y la aplica.

Sintaxis

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Update-DscConfiguration se conecta a un servidor de extracción, descarga la configuración si difiere de lo que está activo en el nodo y, a continuación, aplica la configuración al equipo.

Este cmdlet solo está disponible como parte del paquete acumulativo de actualizaciones de noviembre de 2014 de para Windows RT 8.1, Windows 8.1 y Windows Server 2012 R2.

Ejemplos

Ejemplo 1: Actualización de una configuración

Update-DscConfiguration -Wait -Verbose

Después de ejecutar este comando, el servidor se conectará al servicio de extracción registrado, descargará la configuración asignada más reciente y, a continuación, la aplicará. Los parámetros Wait y verbose son opcionales. Al trabajar de forma interactiva, estos parámetros combinados permiten comentarios en tiempo real sobre el progreso y el éxito o el error al aplicar la configuración.

Ejemplo 2: Actualización de una configuración mediante la conexión a través de una sesión CIM

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

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 actualiza el equipo especificado en el CimSession almacenado en $Session. El comando especifica el parámetro wait . La consola no acepta comandos adicionales hasta que finalice el comando actual.

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. El cmdlet aplica las opciones de configuración a los equipos que especifica este parámetro.

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

-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

-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

-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