Partilhar via

Start-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Aplica a configuração aos 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 aos 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 computadores ou usando sessões 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 definições de configuração.

Exemplos

Exemplo 1: Aplicar definições de configuração

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

Este comando aplica as definições de configuração do C:\DSC\Configurations\ a todos os computadores que têm definições nessa pasta. O comando retorna objetos de de trabalho para cada nó de destino implantado.

Exemplo 2: Aplicar definições de configuração e aguardar a conclusão da configuração

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

Este comando aplica a configuração do C:\DSC\Configurations\ ao computador local. O comando retorna objetos Job para cada nó de destino implantado, neste caso, apenas no computador local. Este exemplo especifica o parâmetro Verbose. Portanto, o comando envia mensagens para o console à medida que prossegue. O comando inclui o parâmetro Wait. Portanto, você não pode usar o console até que o comando termine todas as tarefas de configuração.

Exemplo 3: Aplicar definições de configuração usando uma sessão CIM

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

Este exemplo aplica definições de configuração 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, em seguida, 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 definições de configuração do C:\DSC\Configurations aos computadores identificados 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 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 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 configuraçã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

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 o alterará para Push.

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

-JobName

Especifica um nome amigável para um trabalho. Se você especificar esse parâmetro, o cmdlet será executado como um trabalho e retornará um Job objeto.

Por padrão, o Windows PowerShell atribui o nome JobN onde N é um inteiro.

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

Tipo:String
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. Este cmdlet publica e aplica essas definições de configuração a computadores que têm arquivos de configurações no caminho especificado. Cada nó de destino deve ter um arquivo de configurações do seguinte formato: <NetBIOS Name>.mof.

Tipo:String
Position:0
Default value:None
Necessário:False
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

-UseExisting

Indica que esse cmdlet aplica a configuração existente. A configuração pode existir no computador de destino por promulgação usando Start-DscConfiguration ou por publicação usando o cmdlet Publish-DscConfiguration.

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
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