Get-DscConfiguration
Obtém a configuração atual dos nós.
Sintaxe
Default (Predefinição)
Get-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Description
O cmdlet Get-DscConfiguration obtém a configuração atual dos nós, se a configuração existir. Especifique computadores usando sessões CIM (Common Information Model). Se você não especificar um computador de destino, o cmdlet obterá a configuração do computador local.
Exemplos
Exemplo 1: Obter a configuração para o computador local
Get-DscConfiguration
Este comando obtém o estado atual do computador local.
Exemplo 2: Obter a configuração para um computador especificado
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-DscConfiguration -CimSession $Session
Este exemplo obtém o estado atual de um computador especificado por uma sessão CIM. 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 New-CimSession.
O segundo comando obtém a configuração atual para os computadores identificados pelo CimSession objetos armazenados na variável $Session, neste caso, o computador chamado Server01.
Parâmetros
-AsJob
Indica que esse cmdlet executa o comando como um trabalho em segundo plano.
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 |
-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: | |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Sessão |
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 |
-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 |
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.
