Get-WSManInstance

Módulo:

Microsoft.WSMan.Management

Exibe informações de gerenciamento para uma instância de recurso especificada por um URI de Recurso.

Sintaxe

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Description

O cmdlet Get-WSManInstance recupera uma instância de um recurso de gerenciamento especificada por um URI (Uniform Resource Identifier) de recurso. As informações recuperadas podem ser um conjunto de informações XML complexo, que é um objeto ou um valor simples. Esse cmdlet é o equivalente ao comando padrão dos Serviços Web para Gerenciamento (WS-Management) Obter.

Esse cmdlet usa o WS-Management camada de conexão/transporte para recuperar informações.

Exemplos

Exemplo 1: Obter todas as informações do WMI

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

Esse comando retorna todas as informações que a WMI (Instrumentação de Gerenciamento do Windows) expõe sobre o serviço WinRM no computador do servidor remoto01.

Exemplo 2: Obter o status do serviço Spooler

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

Esse comando retorna apenas o status do serviço do Spooler no computador do servidor remoto01.

Exemplo 3: Obter referências de ponto de extremidade para todos os serviços

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

Esse comando retorna referências de ponto de extremidade que correspondem a todos os serviços no computador local.

Exemplo 4: Obter serviços que atendam aos critérios especificados

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

Este comando lista todos os serviços que atendem aos seguintes critérios no computador server01 remoto:

• O tipo de inicialização do serviço é Automático.
• O serviço é interrompido.

Exemplo 5: Obter a configuração do ouvinte que corresponda aos critérios no computador local

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

Esse comando lista a configuração do ouvinte WS-Management no computador local para o ouvinte que corresponde aos critérios no conjunto de seletores.

Exemplo 6: Obter a configuração do ouvinte que corresponda aos critérios em um computador remoto

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

Este comando lista a configuração do ouvinte WS-Management no computador server01 remoto para o ouvinte que corresponde aos critérios no conjunto de seletores.

Exemplo 7: Obter instâncias associadas relacionadas a uma instância especificada

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Esse comando obtém as instâncias associadas relacionadas à instância especificada (winrm).

Você deve colocar o filtro entre aspas, conforme mostrado no exemplo.

Exemplo 8: Obter instâncias de associação relacionadas a uma instância especificada

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Esse comando obtém instâncias de associação relacionadas à instância especificada (winrm). Como o dialeto valor é associação e o parâmetro associações de é usado, esse comando retorna instâncias de associação, não instâncias associadas.

Você deve colocar o filtro entre aspas, conforme mostrado no exemplo.

Parâmetros

-ApplicationName

Especifica o nome do aplicativo na conexão. O valor padrão do parâmetro ApplicationName é WSMAN. O identificador completo do ponto de extremidade remoto está no seguinte formato:

< >de transporte :///>de servidor de<:>de porta</<ApplicationName>

Por exemplo: http://server01:8080/WSMAN

O IIS (Serviços de Informações da Internet), que hospeda a sessão, encaminha solicitações com esse ponto de extremidade para o aplicativo especificado. Essa configuração padrão do WSMAN é apropriada para a maioria dos usos. Esse parâmetro será projetado para ser usado se muitos computadores estabelecerem conexões remotas com um computador que esteja executando o PowerShell. Nesse caso, os hosts do IIS WS-Management para eficiência.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Associations

Indica que esse cmdlet obtém instâncias de associação, não instâncias associadas. Você só pode usar esse parâmetro quando o parâmetro Dialeto tiver um valor de Associação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Authentication

Especifica o mecanismo de autenticação a ser usado no servidor. Os valores aceitáveis para este parâmetro são:

• Basic - Básico é um esquema no qual o nome de usuário e a senha são enviados em texto claro para o servidor ou proxy.
• Default - Use o método de autenticação implementado pelo protocolo WS-Management. Esse é o padrão.
• Digest – Digest é um esquema de desafio-resposta que usa uma cadeia de caracteres de dados especificada pelo servidor para o desafio.
• Kerberos – o computador cliente e o servidor se autenticam mutuamente usando certificados Kerberos.
• Negotiate - Negociar é um esquema de desafio-resposta que negocia com o servidor ou proxy para determinar o esquema a ser usado para autenticação. Por exemplo, esse valor de parâmetro permite que a negociação determine se o protocolo Kerberos ou NTLM é usado.
• CredSSP - Use a autenticação credSSP (Provedor de Suporte à Segurança de Credencial), que permite que o usuário delegar credenciais. Essa opção foi projetada para comandos executados em um computador remoto, mas coletam dados ou executam comandos adicionais em outros computadores remotos.

Cuidado

O CredSSP delega as credenciais do usuário do computador local para um computador remoto. Essa prática aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, quando as credenciais forem passadas para ele, as credenciais poderão ser usadas para controlar a sessão de rede.

Tipo:	AuthenticationMechanism
Aliases:	auth, am
Valores aceitos:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BasePropertiesOnly

Indica que esse cmdlet enumera apenas as propriedades que fazem parte da classe base especificada pelo parâmetro ResourceURI. Esse parâmetro não terá efeito se o parâmetro Shallow for especificado.

Tipo:	SwitchParameter
Aliases:	UBPO, Base
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CertificateThumbprint

Especifica o certificado de chave pública digital (X509) de uma conta de usuário que tem permissão para executar essa ação. Insira a impressão digital do certificado.

Os certificados são usados na autenticação baseada em certificado do cliente. Eles podem ser mapeados apenas para contas de usuário local; eles não funcionam com contas de domínio.

Para obter uma impressão digital do certificado, use o comando Get-Item ou Get-ChildItem na unidade Cert: do PowerShell.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ComputerName

Especifica o computador no qual executar a operação de gerenciamento. O valor pode ser um nome de domínio totalmente qualificado, um nome NetBIOS ou um endereço IP. Use o nome do computador local, use localhost ou use um ponto (.) para especificar o computador local. O computador local é o padrão. Quando o computador remoto estiver em um domínio diferente do usuário, você deverá usar um nome de domínio totalmente qualificado. Você pode redirecionar um valor para esse parâmetro para o cmdlet.

Tipo:	String
Aliases:	CN
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ConnectionURI

Especifica o ponto de extremidade de conexão. O formato dessa cadeia de caracteres é o seguinte:

>de Transporte <:///>do Servidor<:<>de Porta/<ApplicationName>

A seguinte cadeia de caracteres é um valor formatado corretamente para este parâmetro:

http://Server01:8080/WSMAN

O URI deve ser totalmente qualificado.

Tipo:	Uri
Aliases:	CURI, CU
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Credential

Especifica uma conta de usuário que tem permissão para executar essa ação. O padrão é o usuário atual. Digite um nome de usuário, como User01, Domain01\User01 ou User@Domain.com. Ou insira um objeto PSCredential, como um retornado pelo cmdlet Get-Credential. Quando você digita um nome de usuário, esse cmdlet solicita uma senha.

Tipo:	PSCredential
Aliases:	cred, c
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Dialect

Especifica o dialeto a ser usado no predicado de filtro. Esse pode ser qualquer dialeto compatível com o serviço remoto. Os aliases a seguir podem ser usados para o URI do dialeto:

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Seletor – http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Associação – http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Tipo:	Uri
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Enumerate

Indica que esse cmdlet retorna todas as instâncias de um recurso de gerenciamento.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Filter

Especifica a expressão de filtro para a enumeração. Se você especificar esse parâmetro, também deverá especificar Dialeto.

Os valores válidos desse parâmetro dependem do dialeto especificado em Dialeto. Por exemplo, se Dialeto for WQL, o parâmetro de filtro de deverá conter uma cadeia de caracteres e a cadeia de caracteres deverá conter uma consulta WQL válida, como a seguinte consulta:

"Select * from Win32_Service where State != Running"

Se Dialeto for Associação, Filtrar deverá conter uma cadeia de caracteres e a cadeia de caracteres deverá conter um filtro válido, como o seguinte filtro:

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Fragment

Especifica uma seção dentro da instância que deve ser atualizada ou recuperada para a operação especificada. Por exemplo, para obter o status de um serviço de spooler, especifique o seguinte:

-Fragment Status

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OptionSet

Especifica um conjunto de opções para um serviço para modificar ou refinar a natureza da solicitação. Eles são semelhantes a comutadores usados em shells de linha de comando porque são específicos do serviço. Qualquer número de opções pode ser especificado.

O exemplo a seguir demonstra a sintaxe que passa os valores 1, 2 e 3 para os parâmetros a, b e c:

-OptionSet @{a=1;b=2;c=3}

Tipo:	Hashtable
Aliases:	OS
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Port

Especifica a porta a ser usada quando o cliente se conecta ao serviço WinRM. Quando o transporte é HTTP, a porta padrão é 80. Quando o transporte é HTTPS, a porta padrão é 443.

Quando você usa HTTPS como transporte, o valor do parâmetro ComputerName deve corresponder ao CN (nome comum do certificado) do servidor. No entanto, se o parâmetro SkipCNCheck for especificado como parte do parâmetro SessionOption, o nome comum do servidor não precisará corresponder ao nome do host do servidor. O parâmetro SkipCNCheck deve ser usado apenas para computadores confiáveis.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceURI

Especifica o URI da classe de recurso ou instância. O URI identifica um tipo específico de recurso, como discos ou processos, em um computador.

Um URI consiste em um prefixo e um caminho de um recurso. Por exemplo:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Tipo:	Uri
Aliases:	RURI
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ReturnType

Especifica o tipo de dados a serem retornados. Os valores aceitáveis para este parâmetro são:

• Object
• EPR
• ObjectAndEPR

O valor padrão é Object.

Se você especificar Object ou não especificar esse parâmetro, esse cmdlet retornará apenas objetos. Se você especificar referência de ponto de extremidade (EPR), esse cmdlet retornará apenas as referências de ponto de extremidade dos objetos. As referências de ponto de extremidade contêm informações sobre o URI do recurso e os seletores da instância. Se você especificar ObjectAndEPR, esse cmdlet retornará o objeto e suas referências de ponto de extremidade associadas.

Tipo:	String
Aliases:	RT
Valores aceitos:	object, epr, objectandepr
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SelectorSet

Especifica um conjunto de pares de valor que são usados para selecionar instâncias de recurso de gerenciamento específicas. O parâmetro SelectorSet é usado quando há mais de uma instância do recurso. O valor do parâmetro SelectorSet deve ser uma tabela de hash.

O exemplo a seguir mostra como inserir um valor para este parâmetro:

-SelectorSet @{Name="WinRM";ID="yyy"}

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SessionOption

Especifica opções estendidas para a sessão de WS-Management. Insira um objeto SessionOption criado usando o cmdlet New-WSManSessionOption. Para obter mais informações sobre as opções disponíveis, digite Get-Help New-WSManSessionOption.

Tipo:	SessionOption
Aliases:	SO
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Shallow

Indica que esse cmdlet retorna apenas instâncias da classe base especificadas no URI do recurso. Se você não especificar esse parâmetro, esse cmdlet retornará instâncias da classe base especificadas no URI e em todas as classes derivadas.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseSSL

Especifica que o protocolo SSL (Secure Sockets Layer) é usado para estabelecer uma conexão com o computador remoto. Por padrão, o SSL não é usado.

WS-Management criptografa todo o conteúdo do Windows PowerShell transmitido pela rede. O parâmetro UseSSL permite especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta usada para a conexão e você especificar esse parâmetro, o comando falhará.

Tipo:	SwitchParameter
Aliases:	SSL
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Você não pode redirecionar objetos para este cmdlet.

Saídas

XmlElement

Esse cmdlet retorna um objeto XMLElement .

Links Relacionados

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan