Publish-DscConfiguration
Publica uma configuração de 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 DSC (Configuração de Estado Desejado) do Windows PowerShell no conjunto de computadores. Esse 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 LCM (Gerenciador de Configuração Local).
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 documento 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)Esse 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 cmdlet New-CimSession ou Get-CimSession. O padrão é a sessão atual no computador local.
| Tipo: | CimSession[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ComputerName
Especifica um ou mais computadores nos quais esse cmdlet publica a configuração.
| Tipo: | String[] |
| Aliases: | CN, ServerName |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Credential
Especifica as credenciais usadas para acessar o dispositivo de destino.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Força o cmdlet a ser concluído. Se o modo de atualização do Configuration Manager local estiver definido como PULL, o uso desse parâmetro o alterará para PUSH e habilitará a publicação da configuração de DSC. Além disso, se houver uma configuração de DSC pendente, o uso desse parâmetro substituirá essa configuração pendente.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Path
Especifica um caminho que contém configurações a serem publicadas em computadores de destino.
| Tipo: | String |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 ideal para o cmdlet com base no número de cmdlets CIM em execução no computador. O limite de limitação se aplica somente ao cmdlet atual, não à sessão ou ao computador.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
