Get-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Obtém a configuração atual dos nós.

Syntax

Get-DscConfiguration
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

O Get-DscConfiguration cmdlet obtém a configuração atual dos nós, se a configuração existir. Especifique computadores através de sessões do Common Information Model (CIM). Se não especificar um computador de destino, o cmdlet obtém a configuração a partir do computador local.

Exemplos

Exemplo 1: Obter a configuração do computador local

Get-DscConfiguration

Este comando obtém o estado atual do computador local.

Exemplo 2: Obter a configuração de um computador especificado

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-DscConfiguration -CimSession $Session

Este exemplo obtém o estado atual a partir de um computador especificado por uma sessão CIM. 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 variável $Session . O comando pede-lhe uma palavra-passe. Para mais informações, insira Get-Help New-CimSession.

O segundo comando obtém a configuração atual para os computadores identificados pelos objetos CimSession armazenados na variável $Session , neste caso, o computador com o nome Server01.

Parâmetros

-AsJob

Indica que este cmdlet executa o comando como uma tarefa em segundo plano.

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

-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[]
Aliases:Session
Position:Named
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