Objeto WSMan

Fornece métodos e propriedades usados para criar uma sessão, representada por um objeto Session . Todas as operações de Gerenciamento Remoto do Windows exigem a criação de uma Sessão que se conecta a um computador remoto, ao controlador de gerenciamento base (BMC) ou ao computador local. As operações incluem obter, gravar, enumerar dados ou invocar métodos.

Membros

O objeto WSMan tem estes tipos de membros:

Métodos

O objeto WSMan tem esses métodos.

Método Descrição
CreateConnectionOptions Cria um objeto ConnectionOptions que especifica o nome de usuário e a senha usados ao criar uma sessão remota.
CreateResourceLocator Cria um objeto ResourceLocator que pode especificar:
  • O caminho completo para um recurso ou uma única parte dos dados.
  • Um seletor para uma instância específica de um recurso.
  • Uma opção que fornece dados adicionais para o provedor de recursos.
CreateSession Cria um objeto Session que pode ser usado para operações de rede subsequentes.
WSMan.EnumerationFlagHierarchyDeep Retorna o valor do sinalizador de enumeração EnumerationFlagHierarchyDeep para uso no parâmetro flags de Session.Enumerate.
WSMan.EnumerationFlagHierarchyDeepBasePropsOnly Retorna o valor do sinalizador de enumeração EnumerationFlagHierarchyDeepBasePropsOnly para uso no parâmetro flags de Session.Enumerate.
WSMan.EnumerationFlagHierarchyShallow Retorna o valor do sinalizador de enumeração EnumerationFlagHierarchyShallow para uso no parâmetro flags de Session.Enumerate.
WSMan.EnumerationFlagNonXmlText Retorna o valor da constante de enumeração WSManFlagNonXmlText para uso no parâmetro flags do método Session.Enumerate .
WSMan.EnumerationFlagReturnEPR Retorna o valor do sinalizador de enumeração EnumerationFlagReturnEPR para uso no parâmetro flags de Session.Enumerate.
WSMan.EnumerationFlagReturnObject Retorna o valor do sinalizador de enumeração EnumerationFlagReturnObject para uso no parâmetro flags de Session.Enumerate.
WSMan.EnumerationFlagReturnObjectAndEPR Retorna o valor do sinalizador de enumeração EnumerationFlagReturnObjectAndEPR para uso no parâmetro flags de Session.Enumerate.
WSMan.GetErrorMessage Retorna uma cadeia de caracteres formatada que contém o texto de um número de erro.
WSMan.SessionFlagCredUsernamePassword Retorna o valor do sinalizador de autenticação WSManFlagCredUsernamePassword para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagEnableSPNServerPort Retorna o valor do sinalizador de autenticação WSManFlagEnableSPNServerPort para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagNoEncryption Retorna o valor do sinalizador de autenticação WSManFlagNoEncryption para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagSkipCACheck Retorna o valor do sinalizador de autenticação WSManFlagSkipCACheck para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagSkipCNCheck Retorna o valor do sinalizador de autenticação WSManFlagSkipCNCheck para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagUseBasic Retorna o valor do sinalizador de autenticação WSManFlagUseBasic para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagUseDigest Retorna o valor do sinalizador de autenticação WSManFlagUseDigest para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagUseKerberos Retorna o valor do sinalizador de autenticação WSManFlagUseKerberos para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagUseNegotiate Retorna o valor do sinalizador de autenticação WSManFlagUseNegotiate para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagUseNoAuthentication Retorna o valor do sinalizador de autenticação WSManFlagUseNoAuthentication para uso no parâmetro flags de WSMan.CreateSession.
WSMan.SessionFlagUTF8 Retorna o valor do sinalizador de autenticação WSManFlagUTF8 para uso no parâmetro flags de WSMan.CreateSession.

Propriedades

O objeto WSMan tem essas propriedades.

Propriedade Tipo de acesso Descrição
CommandLine
Somente leitura
Obtém a linha de comando não processada para o processo de hospedagem atual.
Erro do
Somente leitura
Obtém informações de erro.

Comentários

O objeto WSMan corresponde às interfaces IWSMan e IWSManEx . WSMan é o único objeto que pode ser criado diretamente usando CreateObject.

Exemplos

O exemplo de código a seguir mostra como instanciar um objeto WSMan .

Dim objWsman
Dim Session, Resource 
Set objWsman = CreateObject( "WSMAN.Automation" )
Set Session = objWsman.CreateSession
strResource = "http://schemas.microsoft.com/wbem/wsman/1/wmi/Root/CIMv2/Win32_OperatingSystem"

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Cabeçalho
WSManDisp.h
IDL
WSManDisp.idl
Biblioteca
WSManDisp.tlb
DLL
WSMAuto.dll

Confira também

API de script do WinRM

Sobre o Gerenciamento Remoto do Windows

Usando o Gerenciamento Remoto do Windows

Scripts no Gerenciamento Remoto do Windows

Obtendo dados do computador local

Obtendo dados de um computador remoto