Partilhar via

Start-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Aplica a configuração aos nós.

Syntax

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 Start-DscConfiguration cmdlet aplica a configuração aos nós. Quando utilizado com o parâmetro UseExisting , é aplicada a configuração existente no computador de destino. Especifique os computadores aos quais pretende aplicar a configuração ao especificar nomes de computador ou através de sessões do Common Information Model (CIM).

Por predefinição, este cmdlet cria uma tarefa e devolve um objeto Tarefa . Para obter mais informações sobre tarefas em segundo plano, escreva Get-Help about_Jobs. Para utilizar este cmdlet interativamente, especifique o parâmetro Aguardar .

Especifique o parâmetro Verbose para ver os detalhes do que o cmdlet faz quando aplica as 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 de C:\DSC\Configurations\ todos os computadores que têm definições nessa pasta. O comando devolve objetos de Tarefa para cada nó de destino implementado.

Exemplo 2: Aplicar definições de configuração e aguardar que a configuração seja concluída

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

Este comando aplica a configuração do C:\DSC\Configurations\ para o computador local. O comando devolve objetos de tarefa para cada nó de destino implementado para, neste caso, apenas o computador local. Este exemplo especifica o parâmetro Verboso . Por conseguinte, o comando envia mensagens para a consola à medida que avança. O comando inclui o parâmetro Aguardar . Por conseguinte, não pode utilizar a consola até que o comando conclua todas as tarefas de configuração.

Exemplo 3: Aplicar definições de configuração com 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 com o nome Server01 para utilização com o cmdlet . Em 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 com o New-CimSession cmdlet e, em seguida, armazena o objeto CimSession na $Session variável . O comando pede-lhe uma palavra-passe. Para mais informações, insira Get-Help NewCimSession.

O segundo comando aplica as definições de configuração de C:\DSC\Configurations para os computadores identificados pelos objetos CimSession armazenados na $Session variável. Neste exemplo, a $Session variável contém uma sessão CIM apenas para o computador com o nome Server01. O comando aplica a configuração. O comando cria objetos de Tarefa para cada computador configurado.

Parâmetros

-CimSession

Executa o cmdlet numa sessão remota ou num computador remoto. Introduza um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . A predefinição é a sessão atual no computador local.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica uma matriz de nomes de computadores. Este parâmetro restringe os computadores que têm documentos de configuração no parâmetro Caminho para os especificados na matriz.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica um nome de utilizador e palavra-passe, como um objeto PSCredential , para o computador de destino. Para obter um objeto PSCredential , utilize o Get-Credential cmdlet . Para mais informações, insira Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 da Configuration Manager Local estiver definida como Pull, especificar este parâmetro altera-a para Push.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobName

Especifica um nome amigável para uma tarefa. Se especificar este parâmetro, o cmdlet é executado como uma tarefa e devolve um objeto Job .

Por predefinição, Windows PowerShell atribui o nome JobN em que N é um número inteiro.

Se especificar o parâmetro Aguardar , não especifique este parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica um caminho de ficheiro de uma pasta que contém ficheiros de definições de configuração. Este cmdlet publica e aplica estas definições de configuração a computadores com ficheiros de definições no caminho especificado. Cada nó de destino tem de ter um ficheiro de definições com o seguinte formato: <NetBIOS Name>.mof.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se este parâmetro for omitido ou for introduzido um valor de0, Windows PowerShell calcula um limite de limitação ideal para o cmdlet com base no número de cmdlets CIM que estão em execução no computador. O limite de limitação aplica-se apenas ao cmdlet atual, não à sessão ou ao computador.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseExisting

Indica que este cmdlet aplica a configuração existente. A configuração pode existir no computador de destino através da promulgação com Start-DscConfiguration ou através da publicação através do cmdlet Publish-DscConfiguration.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Wait

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

Se especificar este parâmetro, não especifique o parâmetro JobName .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False