Publish-DscConfiguration
Publica una configuración de DSC en un conjunto de equipos.
Sintaxis
Publish-DscConfiguration
[-Path] <String>
[-Force]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Publish-DscConfiguration
[-Path] <String>
[-Force]
[-ThrottleLimit <Int32>]
-CimSession <CimSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet Publish-DscConfiguration publica un documento de configuración de Desired State Configuration (DSC) de Windows PowerShell en el conjunto de equipos. Este cmdlet no aplica la configuración.
El cmdlet Start-DscConfiguration aplica configuraciones cuando se usa con el parámetro use UseExisting o cuando el motor de DSC ejecute su ciclo de coherencia. El motor de DSC también se conoce como Administrador de configuración local (LCM).
Este cmdlet es especialmente útil cuando se entregan fragmentos de varios documentos de configuración. Cuando se entregan varios fragmentos de documentos de configuración, sobrescriben los fragmentos de documento de configuración anteriores.
Ejemplos
Ejemplo 1: Publicación de una configuración en un equipo remoto
Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)Este comando publica una configuración en un equipo remoto. El usuario que ejecuta el cmdlet debe ser administrador en el equipo remoto.
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 uno o varios equipos en los que este cmdlet publica la configuración.
| 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 las credenciales que se usan para acceder al dispositivo de destino.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Obliga al cmdlet a finalizar. Si el modo de actualización de Local Configuration Manager está establecido en PULL, el uso de este parámetro lo cambia a PUSH y habilita la publicación de la configuración de DSC. Además, si existe una configuración de DSC pendiente, el uso de este parámetro sobrescribe esa configuración pendiente.
| 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 que contiene configuraciones para publicar en equipos de destino.
| 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 |
