Ler em inglês

Compartilhar via


Windows Remote Management

Visão geral da tecnologia de Gerenciamento Remoto do Windows.

Para desenvolver o Gerenciamento Remoto do Windows, você precisa destes cabeçalhos:

Para obter diretrizes de programação para essa tecnologia, confira:

Enumerações

 
WSManAuthenticationFlags

Determina o método de autenticação para a operação.
WSManCallbackFlags

Define um conjunto de sinalizadores usados por todas as funções de retorno de chamada.
WSManDataType

Especifica o tipo de dados atual da união na estrutura WSMAN_DATA.
WSManProxyAccessType

Define o tipo de acesso de proxy.
WSManProxyAccessTypeFlags

Define os sinalizadores de tipo de acesso de proxy.
WSManProxyAuthenticationFlags

Determina o mecanismo de autenticação de proxy.
WSManSessionOption

Define um conjunto de opções estendidas para a sessão. Essas opções são usadas com o método WSManSetSessionOption.

Funções

 
AddOption

Adiciona dados necessários para processar a solicitação. Por exemplo, alguns provedores WMI podem exigir um objeto IWbemContext ou SWbemNamedValueSet com informações específicas do provedor.
AddSelector

Adiciona um seletor ao objeto ResourceLocator. O seletor especifica uma instância específica de um recurso.
ClearOptions

Remove todas as opções do objeto ResourceLocator.
ClearSelectors

Remove todos os seletores de um objeto ResourceLocator. Você pode fornecer um objeto ResourceLocator em vez de especificar um URI de recurso em operações de objeto IWSManSession, como Get, Put ou Enumerate.
Criar

Cria uma nova instância de um recurso e retorna a EPR (referência de ponto de extremidade) do novo objeto.
CreateConnectionOptions

Cria um objeto IWSManConnectionOptions que especifica o nome de usuário e a senha usados ao criar uma sessão.
CreateResourceLocator

Cria um objeto ResourceLocator que pode ser usado em vez de um URI de recurso em operações de objeto De sessão, como IWSManSession.Get, IWSManSession.Put ou Session.Enumerate.
CreateSession

Cria um objeto Session que pode ser usado para operações de rede subsequentes.
Excluir

Exclui o recurso especificado no URI do recurso.
Enumerar

Enumera uma tabela, uma coleta de dados ou um recurso de log.
EnumerationFlagHierarchyDeep

Retorna o valor da constante de enumeração EnumerationFlagHierarchyDeep para uso no parâmetro flags do método IWSManSession::Enumerate.
EnumerationFlagHierarchyDeepBasePropsOnly

Retorna o valor da constante de enumeração EnumerationFlagHierarchyDeepBasePropsOnly para uso no parâmetro flags do método IWSManSession::Enumerate.
EnumerationFlagHierarchyShallow

Retorna o valor da constante de enumeração EnumerationFlagHierarchyShallow para uso no parâmetro flags do método IWSManSession::Enumerate.
EnumerationFlagNonXmlText

Retorna o valor da constante de enumeração WSManFlagNonXmlText para uso no parâmetro flags do método IWSManSession::Enumerate.
EnumerationFlagReturnEPR

Retorna o valor da constante de enumeração EnumerationFlagReturnEPR para uso no parâmetro flags do método IWSManSession::Enumerate.
EnumerationFlagReturnObject

Retorna o valor da constante de enumeração EnumerationFlagReturnObject para uso no parâmetro flags do método IWSManSession::Enumerate.
EnumerationFlagReturnObjectAndEPR

Retorna o valor da constante de enumeração EnumerationFlagReturnObjectAndEPR para uso no parâmetro flags do método IWSManSession::Enumerate.
Get

Recupera o recurso especificado pelo URI e retorna uma representação XML da instância atual do recurso.
get_AtEndOfStream

Indica que o fim dos itens no objeto IWSManEnumerator foi atingido por chamadas para IWSManEnumerator::ReadItem.
get_BatchItems

Define e obtém o número de itens em cada lote de enumeração. (Obter)
get_CertificateThumbprint

Define ou obtém a impressão digital do certificado a ser usada ao autenticar usando a autenticação de certificado do cliente. (Obter)
get_CommandLine

Obtém a linha de comando do processo que carrega o componente de automação.
get_Error

Obtém informações de erro adicionais, em um fluxo XML, para a chamada anterior a um método IWSMan se o serviço de Gerenciamento Remoto do Windows não puder criar um objeto IWSManSession, um objeto IWSManConnectionOptions ou um objeto IWSManResourceLocator.
get_Error

Obtém uma representação XML de informações de erro adicionais. (IWSManEnumerator.get_Error)
get_Error

Obtém uma representação XML de informações de erro adicionais. (IWSManResourceLocator.get_Error)
get_Error

Obtém informações de erro adicionais em um fluxo XML para a chamada anterior a um método de objeto IWSManSession.
get_FragmentDialect

Obtém ou define o dialeto de idioma para um dialeto de fragmento de recurso quando IWSManResourceLocator é usado em métodos de objeto IWSManSession, como Get, Put ou Enumerate. (Obter)
get_FragmentPath

Obtém ou define o caminho de um fragmento de recurso ou propriedade quando ResourceLocator é usado em métodos de objeto IWSManSession, como Get, Put ou Enumerate. (Obter)
get_MustUnderstandOptions

Obtém ou define o valor MustUnderstandOptions para o objeto ResourceLocator. (Obter)
get_ResourceURI

O URI do recurso solicitado. Essa propriedade pode conter apenas o caminho, não uma cadeia de caracteres de consulta para instâncias específicas. (Obter)
get_Timeout

Define e obtém a quantidade máxima de tempo, em milissegundos, que o aplicativo cliente aguarda que o Gerenciamento Remoto do Windows conclua suas operações. (Obter)
get_UserName

Define e obtém o nome de usuário de uma conta local ou de domínio no computador remoto. Essa propriedade determina o nome de usuário para autenticação. (Obter)
GetErrorMessage

Retorna uma cadeia de caracteres formatada que contém o texto de um número de erro.
Identificar

Consulta um computador remoto para determinar se ele dá suporte ao protocolo WS-Management.
Invoke

Invoca um método e retorna resultados da chamada de método.
ProxyAuthenticationUseBasic

Retorna o valor do sinalizador de autenticação de proxy WSManFlagProxyAuthenticationUseBasic para uso no parâmetro authenticationMechanism do método IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseDigest

Retorna o valor do sinalizador de autenticação de proxy WSManFlagProxyAuthenticationUseDigest para uso no parâmetro authenticationMechanism do método IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseNegotiate

Retorna o valor do sinalizador de autenticação de proxy WSManFlagProxyAuthenticationUseNegotiate para uso no parâmetro authenticationMechanism do método IWSManConnectionOptionsEx2::SetProxy.
ProxyAutoDetect

Retorna o valor do sinalizador de tipo de acesso proxy WSManProxyAutoDetect para uso no parâmetro accessType do método IWSManConnectionOptionsEx2::SetProxy.
ProxyIEConfig

Retorna o valor do sinalizador de tipo de acesso proxy WSManProxyIEConfig para uso no parâmetro accessType do método IWSManConnectionOptionsEx2::SetProxy.
ProxyNoProxyServer

Retorna o valor do sinalizador de tipo de acesso proxy WSManProxyNoProxyServer para uso no parâmetro accessType do método IWSManConnectionOptionsEx2::SetProxy.
ProxyWinHttpConfig

Retorna o valor do sinalizador de tipo de acesso proxy WSManProxyWinHttpConfig para uso no parâmetro accessType do método IWSManConnectionOptionsEx2::SetProxy.
Colocar

Atualiza um recurso.
put_BatchItems

Define e obtém o número de itens em cada lote de enumeração. (Put)
put_CertificateThumbprint

Define ou obtém a impressão digital do certificado a ser usada ao autenticar usando a autenticação de certificado do cliente. (Put)
put_FragmentDialect

Obtém ou define o dialeto da linguagem para um dialeto de fragmento de recurso quando IWSManResourceLocator é usado em métodos de objeto IWSManSession, como Get, Put ou Enumerate. (Put)
put_FragmentPath

Obtém ou define o caminho de um fragmento de recurso ou propriedade quando ResourceLocator é usado em métodos de objeto IWSManSession, como Get, Put ou Enumerate. (Put)
put_MustUnderstandOptions

Obtém ou define o valor MustUnderstandOptions para o objeto ResourceLocator. (Put)
put_Password

Define a senha de uma conta local ou de domínio no computador remoto.
put_ResourceURI

O URI de recurso do recurso solicitado. Essa propriedade pode conter apenas o caminho, não uma cadeia de caracteres de consulta para instâncias específicas. (Put)
put_Timeout

Define e obtém a quantidade máxima de tempo, em milissegundos, que o aplicativo cliente aguarda o Gerenciamento Remoto do Windows concluir suas operações. (Put)
put_UserName

Define e obtém o nome de usuário de uma conta local ou de domínio no computador remoto. Essa propriedade determina o nome de usuário para autenticação. (Put)
Readitem

Recupera um item do recurso e retorna uma representação XML do item.
SessionFlagCredUsernamePassword

Retorna o valor do sinalizador de autenticação WSManFlagCredUsernamePassword para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagEnableSPNServerPort

Retorna o valor do sinalizador de autenticação WSManFlagEnableSPNServerPort para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagNoEncryption

Retorna o valor do sinalizador de autenticação WSManFlagNoEncryption para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagSkipCACheck

Retorna o valor do sinalizador de autenticação WSManFlagSkipCACheck para uso no parâmetro flags do método IWSMan::CreateSession.
SessionFlagSkipCNCheck

Retorna o valor do sinalizador de autenticação WSManFlagSkipCNCheck para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseBasic

Retorna o valor do sinalizador de autenticação WSManFlagUseBasic para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseClientCertificate

Retorna o valor do sinalizador de autenticação WSManFlagUseClientCertificate para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseCredSsp

Retorna o valor do sinalizador de autenticação WSManFlagUseCredSsp para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseDigest

Retorna o valor do sinalizador de autenticação WSManFlagUseDigest para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseKerberos

Retorna o valor do sinalizador de autenticação WSManFlagUseKerberos para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseNegotiate

Retorna o valor do sinalizador de autenticação WSManFlagUseNegotiate para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUseNoAuthentication

Retorna o valor do sinalizador de autenticação WSManFlagUseNoAuthentication para uso no parâmetro flags de IWSMan::CreateSession.
SessionFlagUTF8

Retorna o valor do sinalizador de autenticação WSManFlagUTF8 para uso no parâmetro flags de IWSMan::CreateSession.
SetProxy

Define as informações de proxy para a sessão.
WSMAN_PLUGIN_AUTHORIZE_OPERATION

Autoriza uma operação específica.
WSMAN_PLUGIN_AUTHORIZE_QUERY_QUOTA

Recupera informações de cota para o usuário depois que uma conexão é autorizada.
WSMAN_PLUGIN_AUTHORIZE_RELEASE_CONTEXT

Libera o contexto que um plug-in relata de WSManPluginAuthzUserComplete ou WSManPluginAuthzOperationComplete.
WSMAN_PLUGIN_AUTHORIZE_USER

Autoriza uma conexão.
WSMAN_PLUGIN_COMMAND

Define o retorno de chamada de comando para um plug-in.
WSMAN_PLUGIN_CONNECT

Define o retorno de chamada de conexão para um plug-in.
WSMAN_PLUGIN_RECEIVE

Define o retorno de chamada de recebimento para um plug-in.
WSMAN_PLUGIN_RELEASE_COMMAND_CONTEXT

Define o retorno de chamada de comando de versão para o plug-in.
WSMAN_PLUGIN_RELEASE_SHELL_CONTEXT

Define o retorno de chamada do shell de versão para o plug-in.
WSMAN_PLUGIN_SEND

Define o retorno de chamada de envio para um plug-in.
WSMAN_PLUGIN_SHELL

Define o retorno de chamada do shell para um plug-in.
WSMAN_PLUGIN_SHUTDOWN

Define o retorno de chamada de desligamento para o plug-in.
WSMAN_PLUGIN_SIGNAL

Define o retorno de chamada de sinal para um plug-in.
WSMAN_PLUGIN_STARTUP

Define o retorno de chamada de inicialização para o plug-in.
WSMAN_SHELL_COMPLETION_FUNCTION

A função de retorno de chamada que é chamada para operações de shell, que resultam em uma solicitação remota.
WSManCloseCommand

Exclui um comando e libera os recursos associados a ele.
WSManCloseOperation

Cancela ou fecha uma operação assíncrona.
WSManCloseSession

Fecha um objeto de sessão.
WSManCloseShell

Exclui um objeto shell e libera os recursos associados ao shell.
WSManConnectShell

Conecta-se a uma sessão de servidor existente.
WSManConnectShellCommand

Conecta-se a um comando existente em execução em um shell.
WSManCreateSession

Cria um objeto de sessão.
WSManCreateShell

Cria um objeto shell.
WSManCreateShellEx

Cria um objeto shell usando a mesma funcionalidade que a função WSManCreateShell, com a adição de uma ID de shell especificada pelo cliente.
WSManDeinitialize

Desinitializa a pilha de clientes do Gerenciamento Remoto do Windows.
WSManDisconnectShell

Desconecta a conexão de rede de um shell ativo e seus comandos associados.
WSManGetErrorMessage

Recupera as mensagens de erro associadas a um erro específico e códigos de idioma.
WSManGetSessionOptionAsDword

Obtém o valor de uma opção de sessão. (WSManGetSessionOptionAsDword)
WSManGetSessionOptionAsString

Obtém o valor de uma opção de sessão. (WSManGetSessionOptionAsString)
WSManInitialize

Inicializa a API do Cliente de Gerenciamento Remoto do Windows.
WSManPluginAuthzOperationComplete

Relata uma autorização bem-sucedida ou com falha para uma operação de usuário.
WSManPluginAuthzQueryQuotaComplete

Chamado do ponto de entrada do plug-in WSManPluginAuthzQueryQuota e deve ser chamado se o plug-in pode ou não realizar a solicitação.
WSManPluginAuthzUserComplete

Relata uma autorização de conexão de usuário bem-sucedida ou com falha.
WSManPluginFreeRequestDetails

Libera memória alocada para a estrutura de WSMAN_PLUGIN_REQUEST, que é passada para pontos de entrada de plug-in de operação.
WSManPluginGetOperationParameters

Obtém informações operacionais para itens como tempos limite e restrições de dados associados à operação.
WSManPluginOperationComplete

Relata a conclusão de uma operação por todos os pontos de entrada de operação, exceto os métodos WSManPluginStartup e WSManPluginShutdown.
WSManPluginReceiveResult

Relata os resultados da chamada de plug-in WSMAN_PLUGIN_RECEIVE e é usado pela maioria dos plug-ins de shell que retornam resultados.
WSManPluginReportContext

Relata o shell e o contexto de comando de volta à infraestrutura do WinRM (Gerenciamento Remoto do Windows) para que outras operações possam ser executadas no shell e/ou no comando .
WSManReceiveShellOutput

Recupera a saída de um comando em execução ou do shell.
WSManReconnectShell

Reconecta uma sessão de shell desconectada anteriormente. Para reconectar os comandos associados da sessão do shell, use WSManReconnectShellCommand.
WSManReconnectShellCommand

Reconecta um comando desconectado anteriormente.
WSManRunShellCommand

Inicia a execução de um comando em um shell existente e não aguarda a conclusão do comando.
WSManRunShellCommandEx

Fornece a mesma funcionalidade que a função WSManRunShellCommand, com a adição de uma opção de ID de comando.
WSManSendShellInput

Ipes o fluxo de entrada para um comando em execução ou para o shell.
WSManSetSessionOption

Define um conjunto estendido de opções para a sessão.
WSManSignalShell

Envia um código de controle para um comando existente ou para o próprio shell.

Interfaces

 
IWSMan

Fornece métodos e propriedades usados para criar uma sessão, representada por um objeto Session.
IWSManConnectionOptions

O objeto IWSManConnectionOptions é passado para o método IWSMan::CreateSession para fornecer o nome de usuário e a senha associados à conta local no computador remoto.
IWSManConnectionOptionsEx

O objeto IWSManConnectionOptionsEx é passado para o método IWSMan::CreateSession para fornecer a impressão digital do certificado do cliente usado para autenticação.
IWSManConnectionOptionsEx2

O objeto IWSManConnectionOptionsEx2 é passado para o método IWSMan::CreateSession para fornecer o mecanismo de autenticação, o tipo de acesso e as credenciais para se conectar a um servidor proxy.
IWSManEnumerator

Representa um fluxo de resultados retornados de operações como uma operação WS-Enumeration:Enumerate de protocolo WS-Management.
IWSManEx

Estende os métodos e as propriedades da interface IWSMan para incluir a criação de objetos IWSManResourceLocator, métodos que retornam valores de enumeração e sinalizador de sessão e um método para obter informações de erro estendidas.
IWSManEx2

Estende os métodos e as propriedades da interface IWSManEx para incluir um método que retorna um valor de sinalizador de sessão relacionado à autenticação usando certificados de cliente.
IWSManEx3

Estende os métodos e as propriedades da interface IWSManEx para incluir um método que retorna um valor de sinalizador de sessão relacionado à autenticação usando o CredSSP (Provedor de Suporte de Segurança de Credencial).
IWSManResourceLocator

Fornece o caminho para um recurso. Você pode usar um objeto IWSManResourceLocator em vez de um URI de recurso em operações de objeto IWSManSession, como IWSManSession.Get, IWSManSession.Put ou IWSManSession.Enumerate.
IWSManSession

Define as operações e as configurações de sessão.

Estruturas

 
WSMAN_AUTHENTICATION_CREDENTIALS

Define o método de autenticação e as credenciais usadas para autenticação de servidor ou proxy.
WSMAN_AUTHZ_QUOTA

Relata informações de cota por usuário para plug-ins de autorização.
WSMAN_CERTIFICATE_DETAILS

Armazena informações do cliente para uma solicitação de entrada que foi enviada com um certificado do cliente.
WSMAN_COMMAND_ARG_SET

Representa o conjunto de argumentos que são passados para a linha de comando.
WSMAN_DATA

Contém dados de entrada e saída usados na API do WinRM (Gerenciamento Remoto do Windows).
WSMAN_DATA_BINARY

Contém dados binários para uso com várias funções de Gerenciamento Remoto do Windows.
WSMAN_DATA_TEXT

Contém dados textuais para uso com várias funções de Gerenciamento Remoto do Windows.
WSMAN_ENVIRONMENT_VARIABLE

Define uma variável de ambiente individual usando um par de nome e valor.
WSMAN_ENVIRONMENT_VARIABLE_SET

Define uma matriz de variáveis de ambiente.
WSMAN_ERROR

Contém informações de erro retornadas por um cliente WinRM (Gerenciamento Remoto do Windows).
WSMAN_FILTER

WSMAN_FILTER é reservado para uso futuro.
WSMAN_FRAGMENT

WSMAN_FRAGMENT é reservado para uso futuro.
WSMAN_KEY

Representa um par de chave e valor em um conjunto de seletores e é usado para identificar um recurso específico.
WSMAN_OPERATION_INFO

Representa um ponto de extremidade de recurso específico para o qual o plug-in deve executar a solicitação.
WSMAN_OPTION

Representa um par de valores e nome de opção específicos.
WSMAN_OPTION_SET

Representa um conjunto de opções.
WSMAN_PLUGIN_REQUEST

Especifica informações para uma solicitação de plug-in.
WSMAN_PROXY_INFO

Especifica informações de proxy.
WSMAN_RECEIVE_DATA_RESULT

Representa os dados de saída recebidos de um método WSManReceiveShellOutput.
WSMAN_RESPONSE_DATA

Representa os dados de saída recebidos de uma operação do WSMan.
WSMAN_SELECTOR_SET

Define um conjunto de chaves que representam a identidade de um recurso.
WSMAN_SENDER_DETAILS

Especifica os detalhes do cliente para cada solicitação de entrada.
WSMAN_SHELL_ASYNC

Define uma estrutura assíncrona a ser passada para todas as operações de shell.
WSMAN_SHELL_DISCONNECT_INFO

Especifica a duração máxima, em milissegundos, que o shell permanecerá aberto depois que o cliente for desconectado.
WSMAN_SHELL_STARTUP_INFO_V10

A estrutura WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h) define os parâmetros de inicialização do shell a serem usados com a função WSManCreateShell.
WSMAN_SHELL_STARTUP_INFO_V11

A estrutura WSMAN_SHELL_STARTUP_INFO_V11 (wsman.h) define os parâmetros de inicialização do shell a serem usados com a função WSManCreateShell.
WSMAN_STREAM_ID_SET

Lista todos os fluxos usados para entrada ou saída para o shell e os comandos.
WSMAN_USERNAME_PASSWORD_CREDS

Define as credenciais usadas para autenticação.