Compartilhar via

Start-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Aplica a configuração a nós.

Sintaxe

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

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.

Exemplos

Exemplo 1: Aplicar configurações

Start-DscConfiguration -Path "C:\DSC\Configurations\"

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

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

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

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

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.

Tipo:CimSession[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ComputerName

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.

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 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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobName

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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

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.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
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

-UseExisting

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.

Antes de especificar esse parâmetro para este cmdlet, examine as informações em Novidades no Windows PowerShell 5.0.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Wait

Indica que o cmdlet bloqueia o console até concluir todas as tarefas de configuração.

Se você especificar esse parâmetro, não especifique o parâmetro JobName.

Tipo:SwitchParameter
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