Get-WSManInstance

Referência

Módulo:: Microsoft.WSMan.Management

Apresenta informações de gestão de uma instância de recurso especificada por um URI de Recurso.

Syntax

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 Get-WSManInstance cmdlet obtém uma instância de um recurso de gestão que é especificada por um Identificador de Recursos Uniforme (URI) do recurso. As informações obtidas podem ser um conjunto de informações XML complexo, que é um objeto ou um valor simples. Este cmdlet é o equivalente ao comando Get dos Serviços Web padrão para Gestão (WS-Management).

Este cmdlet utiliza a camada de ligação/transporte WS-Management para obter informações.

Exemplos

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

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

Este comando devolve todas as informações que o Windows Management Instrumentation (WMI) expõe sobre o serviço WinRM no computador servidor remoto01.

Exemplo 2: obter o estado do serviço Spooler

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

Este comando devolve apenas o estado do serviço Spooler no computador servidor remoto01.

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

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

Este comando devolve referências de ponto final que correspondem a todos os serviços no computador local.

Exemplo 4: Obter serviços que cumpram 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 cumprem os seguintes critérios no computador remoto Server01:

O tipo de arranque do serviço é Automático.
O serviço está parado.

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

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

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

Exemplo 6: obter a configuração do serviço de escuta que corresponda aos critérios num computador remoto

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

Este comando lista a configuração do serviço de escuta WS-Management no computador servidor remoto01 para o serviço de escuta que corresponde aos critérios no conjunto de seletores.

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

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

Este comando obtém as instâncias associadas que estão relacionadas com a instância especificada (winrm).

Tem de colocar o filtro entre aspas, conforme mostrado no exemplo.

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

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

Este comando obtém instâncias de associação relacionadas com a instância especificada (winrm). Uma vez que o valor dialeto é associação e o parâmetro Associações é utilizado, este comando devolve instâncias de associação e não instâncias associadas.

Tem de colocar o filtro entre aspas, conforme mostrado no exemplo.

Parâmetros

-ApplicationName

Especifica o nome da aplicação na ligação. O valor predefinido do parâmetro ApplicationName é WSMAN. O identificador completo do ponto final remoto está no seguinte formato:

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

Os Serviços de Informação Internet (IIS), que aloja a sessão, reencaminham os pedidos com este ponto final para a aplicação especificada. Esta predefinição do WSMAN é adequada para a maioria das utilizações. Este parâmetro foi concebido para ser utilizado se muitos computadores estabelecerem ligações remotas a um computador que esteja a executar o PowerShell. Neste caso, o IIS aloja WS-Management para eficiência.

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

-Associations

Indica que este cmdlet obtém instâncias de associação e não instâncias associadas. Só pode utilizar este parâmetro quando o parâmetro Dialeto tiver um valor de Associação.

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

-Authentication

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

Basic - Básico é um esquema no qual o nome de utilizador e a palavra-passe são enviados em texto claro para o servidor ou proxy.
Default - Utilize o método de autenticação implementado pelo protocolo WS-Management. Esta é a predefinição.
Digest - O Digest é um esquema de resposta a desafios que utiliza uma cadeia de dados especificada pelo servidor para o desafio.
Kerberos - O computador cliente e o servidor autenticam-se mutuamente com certificados Kerberos.
Negotiate - Negociar é um esquema de resposta a desafios que negoceia com o servidor ou proxy para determinar o esquema a utilizar para autenticação. Por exemplo, este valor de parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é utilizado.
CredSSP - Utilize a autenticação do Fornecedor de Suporte de Segurança de Credenciais (CredSSP), que permite ao utilizador delegar credenciais. Esta opção foi concebida para comandos executados num computador remoto, mas que recolhem dados ou executam comandos adicionais noutros computadores remotos.

Atenção

CredSSP delega as credenciais de utilizador do computador local para um computador remoto. Esta prática aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, quando as credenciais forem transmitidas ao mesmo, as credenciais podem ser utilizadas para controlar a sessão de rede.

Type:	AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BasePropertiesOnly

Indica que este cmdlet enumera apenas as propriedades que fazem parte da classe base especificada pelo parâmetro ResourceURI . Este parâmetro não tem qualquer efeito se o parâmetro Raso for especificado.

Type:	SwitchParameter
Aliases:	UBPO, Base
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Especifica o certificado de chave pública digital (X509) de uma conta de utilizador que tem permissão para efetuar esta ação. Introduza o thumbprint do certificado.

Os certificados são utilizados na autenticação baseada em certificados de cliente. Só podem ser mapeadas para contas de utilizador locais; não funcionam com contas de domínio.

Para obter um thumbprint de certificado, utilize o Get-Item comando ou Get-ChildItem na unidade Cert do PowerShell:

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

-ComputerName

Especifica o computador para executar a operação de gestão. O valor pode ser um nome de domínio completamente qualificado, um nome NetBIOS ou um endereço IP. Utilize o nome do computador local, utilize localhost ou utilize um ponto (.) para especificar o computador local. O computador local é a predefinição. Quando o computador remoto está num domínio diferente do utilizador, tem de utilizar um nome de domínio completamente qualificado. Pode encaminhar um valor para este parâmetro para o cmdlet.

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

-ConnectionURI

Especifica o ponto final de ligação. O formato desta cadeia é o seguinte:

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

http://Server01:8080/WSMAN

O URI tem de estar completamente qualificado.

Type:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica uma conta de utilizador com permissão para realizar esta ação. A predefinição é o utilizador atual. Escreva um nome de utilizador, como User01, Domain01\User01 ou User@Domain.com. Em alternativa, introduza um objeto PSCredential , como o Get-Credential devolvido pelo cmdlet. Quando escreve um nome de utilizador, este cmdlet pede-lhe uma palavra-passe.

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Dialect

Especifica o dialecto a utilizar no predicado de filtro. Pode ser qualquer dialeto suportado pelo serviço remoto. Os seguintes aliases podem ser utilizados para o URI do dialecto:

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

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

-Enumerate

Indica que este cmdlet devolve todas as instâncias de um recurso de gestão.

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

-Filter

Especifica a expressão de filtro para a enumeração. Se especificar este parâmetro, também tem de especificar Dialeto.

Os valores válidos deste parâmetro dependem do dialecto especificado no Dialeto. Por exemplo, se Dialeto for WQL, o parâmetro Filtro tem de conter uma cadeia e a cadeia tem de conter uma consulta WQL válida, como a seguinte consulta:

"Select * from Win32_Service where State != Running"

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

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

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

-Fragment

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

-Fragment Status

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

-OptionSet

Especifica um conjunto de comutadores para um serviço para modificar ou refinar a natureza do pedido. Estes parâmetros assemelham-se a comutadores utilizados em shells de linha de comandos porque são específicos do serviço. Qualquer número de opções pode ser especificado.

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

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

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Especifica a porta a utilizar quando o cliente se ligar ao serviço WinRM. Quando o transporte é HTTP, a porta predefinida é 80. Quando o transporte é HTTPS, a porta predefinida é 443.

Quando utiliza HTTPS como transporte, o valor do parâmetro ComputerName tem de corresponder ao nome comum do certificado (CN) do servidor. No entanto, se o parâmetro SkipCNCheck for especificado como parte do parâmetro SessionOption , o nome comum do certificado do servidor não tem de corresponder ao nome do anfitrião do servidor. O parâmetro SkipCNCheck deve ser utilizado apenas para computadores fidedignos.

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

-ResourceURI

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

Um URI consiste num prefixo e num 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

Type:	Uri
Aliases:	RURI
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnType

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

Object
EPR
ObjectAndEPR

O valor predefinido é Object.

Se especificar Object ou não especificar este parâmetro, este cmdlet devolve apenas objetos. Se especificar referência de ponto final (EPR), este cmdlet devolve apenas as referências de ponto final dos objetos. As referências de pontos finais contêm informações sobre o URI do recurso e os seletores da instância. Se especificar ObjectAndEPR, este cmdlet devolve o objeto e as respetivas referências de ponto final associadas.

Type:	String
Aliases:	RT
Accepted values:	object, epr, objectandepr
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

Especifica um conjunto de pares de valores que são utilizados para selecionar instâncias de recursos de gestão específicas. O parâmetro SelectorSet é utilizado quando existe mais do que uma instância do recurso. O valor do parâmetro SelectorSet tem de ser uma tabela hash.

O exemplo seguinte mostra como introduzir um valor para este parâmetro:

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

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

-SessionOption

Especifica opções expandidas para a sessão WS-Management. Introduza um objeto SessionOption que criar com o cmdlet New-WSManSessionOption. Para obter mais informações sobre as opções disponíveis, escreva Get-Help New-WSManSessionOption.

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Shallow

Indica que este cmdlet devolve apenas instâncias da classe base especificada no URI do recurso. Se não especificar este parâmetro, este cmdlet devolve instâncias da classe base especificada no URI e em todas as classes derivadas.

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

-UseSSL

Especifica que o protocolo SSL (Secure Sockets Layer) é utilizado para estabelecer uma ligação ao computador remoto. Por predefinição, o SSL não é utilizado.

WS-Management encripta todo o conteúdo Windows PowerShell transmitido através da rede. O parâmetro UseSSL permite-lhe especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta utilizada para a ligação e especificar este parâmetro, o comando falhará.

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

Entradas

None

Não pode encaminhar objetos para este cmdlet.

Saídas

XmlElement

Este cmdlet devolve um objeto XMLElement .

Get-WSManInstance

Syntax

Description

Exemplos

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

Exemplo 2: obter o estado do serviço Spooler

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

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

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

Exemplo 6: obter a configuração do serviço de escuta que corresponda aos critérios num computador remoto

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

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

Parâmetros

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Entradas

Saídas

Comentários

Recursos adicionais

Get-WSManInstance

Syntax

Description

Exemplos

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

Exemplo 2: obter o estado do serviço Spooler

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

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

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

Exemplo 6: obter a configuração do serviço de escuta que corresponda aos critérios num computador remoto

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

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

Parâmetros

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Entradas

Saídas

Ligações Relacionadas

Comentários

Recursos adicionais