Publish-DscConfiguration

  • Referencia
Módulo:
PSDesiredStateConfiguration

Publica una configuración de DSC en un conjunto de equipos.

Syntax

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 Publish-DscConfiguration cmdlet publica un documento de configuración de Windows PowerShell Desired State Configuration (DSC) en el conjunto de equipos. Este cmdlet no aplica la configuración. Las configuraciones se aplican mediante el cmdlet Start-DscConfiguration cuando se usa con el parámetro UseExisting o cuando el motor de DSC ejecuta su ciclo de coherencia. El motor DSC también se conoce como el Configuration Manager 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 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 uno o varios equipos en los que este cmdlet publica la configuración.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Credential

Especifica las credenciales que se usan para acceder al dispositivo de destino.

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

-Force

Obliga al cmdlet a finalizar. Si el modo de actualización local de Configuration Manager se establece 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.

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

-Path

Especifica una ruta de acceso que contiene configuraciones para publicar en equipos de destino.

Type:String
Position:0
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

-WhatIf

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

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