O cmdlet Start-DscConfiguration aplica a configuração a nós. Quando usado com o parâmetro UseExisting, a configuração existente no computador de destino é aplicada. Especifique a quais computadores você deseja aplicar a configuração especificando nomes de computador ou usando sessões de CIM (Common Information Model).
Por padrão, esse cmdlet cria um trabalho e retorna um objeto Job. Para obter mais informações sobre trabalhos em segundo plano, digite Get-Help about_Jobs. Para usar esse cmdlet interativamente, especifique o parâmetro Wait.
Especifique o parâmetro Verbose para ver detalhes do que o cmdlet faz quando aplica as configurações.
Esse comando aplica as configurações de C:\DSC\Configurations\ a cada computador que tenha configurações nessa pasta. O comando retorna objetos Job para cada nó de destino implantado.
Exemplo 2: aplicar as configurações e aguardar a conclusão da configuração
Esse comando aplica a configuração de C:\DSC\Configurations\ ao computador local. O comando retorna objetos Job para cada nó de destino implantado para, nesse caso, apenas o computador local. Este exemplo especifica o parâmetro Verbose. Portanto, o comando envia mensagens para o console conforme ele prossegue. O comando inclui o parâmetro Wait. Portanto, você não pode usar o console até que o comando conclua todas as tarefas de configuração.
Exemplo 3: Aplicar configurações usando uma sessão CIM
Este exemplo aplica as configurações a um computador especificado. 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 armazena o objeto CimSession na variável $Session. O comando solicita uma senha. Para obter mais informações, digite Get-Help NewCimSession.
O segundo comando aplica as configurações de C:\DSC\Configurations aos computadores identificados pelos objetos CimSession 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 a configuração. O comando cria objetos Job para cada computador configurado.
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.
Especifica uma matriz de nomes de computador. Esse parâmetro restringe os computadores que têm documentos de configuração no parâmetro Path aos especificados na matriz.
Especifica um nome de usuário e uma senha, como um objeto 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.
Interrompe a operação de configuração atualmente em execução no computador de destino e inicia a nova operação de Start-Configuration. Se a propriedade RefreshMode do Gerenciador de Configurações Local estiver definida como pull, especificar esse parâmetro a alterará para Push.
Especifica um nome amigável para um trabalho. Se você especificar esse parâmetro, o cmdlet será executado como um trabalho e ele retornará um objeto Job.
Por padrão, o Windows PowerShell atribui o nome JobN em que N é um inteiro.
Se você especificar o parâmetro Wait, não especifique esse parâmetro.
Especifica um caminho de arquivo de uma pasta que contém arquivos de configuração de configuração. Esse cmdlet publica e aplica essas configurações a computadores que têm arquivos de configuração no caminho especificado. Cada nó de destino deve ter um arquivo de configurações do seguinte formato: <NetBIOS Name>.mof.
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.
Indica que esse cmdlet aplica a configuração existente. A configuração pode existir no computador de destino por meio da promulgação usando Start-DscConfiguration ou publicação usando o cmdlet Publish-DscConfiguration.
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
