Partilhar via

Set-DscLocalConfigurationManager

  • Referência
Módulo:
PSDesiredStateConfiguration

Aplica as configurações do Gerenciador de Configuração Local (LCM) aos nós.

Sintaxe

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-DscLocalConfigurationManager aplica as configurações do LCM, ou metaconfiguração, aos nós. Especifique computadores especificando nomes de computadores ou usando sessões CIM (Common Information Model). Se você não especificar um computador de destino, o cmdlet aplicará as configurações ao computador local.

Exemplos

Exemplo 1: Aplicar configurações de LCM

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Este comando aplica as configurações do LCM do C:\DSC\Configurations\ aos nós de destino. Depois de receber as configurações, o LCM as processa.

Advertência

Se houver vários meta mofs para o mesmo computador armazenados na pasta especificada, apenas o primeiro meta mof será aplicado.

Exemplo 2: Aplicar configurações do LCM usando uma sessão CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session

Este exemplo aplica as configurações do LCM a um computador e aplica as configurações. O exemplo cria uma sessão CIM para um computador chamado Server01 para uso com o cmdlet. Como alternativa, crie uma matriz de sessões CIM para aplicar o cmdlet a vários computadores especificados.

O primeiro comando cria uma sessão CIM usando o cmdlet New-CimSession e, em seguida, armazena o objeto CimSession na variável $Session. O comando solicita uma senha. Para obter mais informações, digite Get-Help New-CimSession.

O segundo comando aplica configurações LCM para o nó de destino de C:\DSC\Configurations\ para o computador identificado pelo CimSession objetos armazenados na variável $Session. Neste exemplo, a variável $Session contém uma sessão CIM somente para o computador chamado Server01. O comando aplica as configurações. Depois de receber as configurações, o LCM as processa.

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 uma matriz de nomes de computador. Este parâmetro restringe os computadores que têm documentos de metaconfiguração no parâmetro Path aos especificados na matriz.

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 um nome de usuário e senha, como um objeto de PSCredential, para o computador de destino. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

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

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

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

-Path

Especifica um caminho de arquivo de uma pasta que contém arquivos de definições de configuração. O cmdlet publica e aplica essas configurações do LCM a computadores que possuem arquivos de configurações no caminho especificado. Cada nó de destino deve ter um arquivo de configurações do seguinte formato: NetBIOS Name.meta.mof.

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