Partilhar via


Publish-DscConfiguration

Publica uma configuração DSC em um conjunto de computadores.

Sintaxe

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 cmdlet Publish-DscConfiguration publica um documento de configuração de Configuração de Estado Desejado (DSC) do Windows PowerShell no conjunto de computadores. Este cmdlet não aplica a configuração. As configurações são aplicadas pelo cmdlet Start-DscConfiguration quando ele é usado com o parâmetro UseExisting ou quando o mecanismo DSC executa seu ciclo de consistência. O mecanismo DSC também é conhecido como o Gerenciador de Configuração Local (LCM).

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

Exemplos

Exemplo 1: Publicar uma configuração em um computador remoto

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

Este comando publica uma configuração em um computador remoto. O usuário que executa o cmdlet deve ser administrador no computador remoto.

Parâmetros

-CimSession

Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um New-CimSession ou cmdlet Get-CimSession. O padrão é a sessão atual no computador local.

Tipo:CimSession[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ComputerName

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

Tipo:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica as credenciais que são usadas para acessar o dispositivo de destino.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Força a conclusão do cmdlet. Se o modo de atualização do Gerenciador de Configurações Local estiver definido como PULL, o uso desse parâmetro o alterará para PUSH e habilitará a publicação da configuração do DSC. Além disso, se existir uma configuração DSC pendente, o uso desse parâmetro substituirá essa configuração pendente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica um caminho que contém configurações a serem publicadas nos computadores de destino.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ThrottleLimit

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False