Partilhar via

Start-DscConfiguration

Módulo:
PSDesiredStateConfiguration Module v1.1

Aplica a configuração aos nós.

Sintaxe

ComputerNameAndPathSet (Predefinição) 

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

CimSessionAndPathSet 

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

ComputerNameAndUseExistingSet 

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

CimSessionAndUseExistingSet 

Start-DscConfiguration
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-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.

Propriedades dos parâmetros

Tipo:

CimSession[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CimSessionAndPathSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionAndUseExistingSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:China, Nome do servidor

Conjuntos de parâmetros

ComputerNameAndPathSet
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerNameAndUseExistingSet
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameAndPathSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerNameAndUseExistingSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameAndPathSet
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionAndPathSet
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerNameAndUseExistingSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CimSessionAndUseExistingSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

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.