Partilhar via

Publish-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Publica uma configuração do DSC num conjunto de computadores.

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

O Publish-DscConfiguration cmdlet publica um documento de configuração Windows PowerShell Desired State Configuration (DSC) no conjunto de computadores. Este cmdlet não aplica a configuração. As configurações são aplicadas pelo cmdlet Start-DscConfiguration quando é utilizado com o parâmetro UseExisting ou quando o motor DSC executa o respetivo ciclo de consistência. O motor DSC também é conhecido como Configuration Manager Local (LCM).

Este cmdlet é especialmente útil quando são entregues fragmentos de vários documentos de configuração. Quando são entregues vários fragmentos de documentos de configuração, substituem os fragmentos de documentos de configuração mais antigos.

Exemplos

Exemplo 1: Publicar uma configuração num computador remoto

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

Este comando publica uma configuração num computador remoto. O utilizador que executa o cmdlet deve ser administrador no computador remoto.

Parâmetros

-CimSession

Executa o cmdlet numa sessão remota ou num computador remoto. Introduza um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . A predefinição é a sessão atual no computador local.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica um ou mais computadores nos quais este cmdlet publica a configuração.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Credential

Especifica as credenciais que são utilizadas para aceder ao dispositivo de destino.

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

-Force

Força o cmdlet a terminar. Se o modo de atualização local Configuration Manager estiver definido como PULL, a utilização deste parâmetro altera-o para PUSH e ativa a publicação da configuração do DSC. Além disso, se existir uma configuração de DSC pendente, a utilização deste parâmetro substitui essa configuração pendente.

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

-Path

Especifica um caminho que contém configurações para publicar em computadores de destino.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se este parâmetro for omitido ou for introduzido um valor de0, Windows PowerShell calcula um limite de limitação ideal para o cmdlet com base no número de cmdlets CIM que estão em execução no computador. O limite de limitação aplica-se apenas ao cmdlet atual, não à sessão ou ao computador.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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