Leer en inglés

Compartir a través de


Administración remota de Windows

Información general sobre la tecnología de administración remota de Windows.

Para desarrollar la administración remota de Windows, necesita estos encabezados:

Para obtener instrucciones de programación para esta tecnología, consulte:

Enumeraciones

 
WSManAuthenticationFlags

Determina el método de autenticación para la operación.
WSManCallbackFlags

Define un conjunto de marcas usadas por todas las funciones de devolución de llamada.
WSManDataType

Especifica el tipo de datos actual de la unión en la estructura WSMAN_DATA.
WSManProxyAccessType

Define el tipo de acceso de proxy.
WSManProxyAccessTypeFlags

Define las marcas de tipo de acceso de proxy.
WSManProxyAuthenticationFlags

Determina el mecanismo de autenticación de proxy.
WSManSessionOption

Define un conjunto de opciones extendidas para la sesión. Estas opciones se usan con el método WSManSetSessionOption.

Functions

 
AddOption

Agrega datos necesarios para procesar la solicitud. Por ejemplo, algunos proveedores de WMI pueden requerir un objeto IWbemContext o SWbemNamedValueSet con información específica del proveedor.
AddSelector

Agrega un selector al objeto ResourceLocator. El selector especifica una instancia determinada de un recurso.
ClearOptions

Quita las opciones del objeto ResourceLocator.
ClearSelectors

Quita todos los selectores de un objeto ResourceLocator. Puede proporcionar un objeto ResourceLocator en lugar de especificar un URI de recurso en operaciones de objeto IWSManSession, como Get, Put o Enumerate.
Crear

Crea una nueva instancia de un recurso y devuelve la referencia de punto de conexión (EPR) del nuevo objeto.
CreateConnectionOptions

Crea un objeto IWSManConnectionOptions que especifica el nombre de usuario y la contraseña usados al crear una sesión.
CreateResourceLocator

Crea un objeto ResourceLocator que se puede usar en lugar de un URI de recurso en operaciones de objeto session como IWSManSession.Get, IWSManSession.Put o Session.Enumerate.
CreateSession

Crea un objeto Session que se puede usar para las operaciones de red posteriores.
Eliminar

Elimina el recurso especificado en el URI del recurso.
Enumerar

Enumera una tabla, una recopilación de datos o un recurso de registro.
EnumerationFlagHierarchyDeep

Devuelve el valor de la constante de enumeración EnumerationFlagHierarchyDeep para su uso en el parámetro flags del método IWSManSession::Enumerate.
EnumerationFlagHierarchyDeepBasePropsOnly

Devuelve el valor de la constante de enumeración EnumerationFlagHierarchyDeepBasePropsOnly para su uso en el parámetro flags del método IWSManSession::Enumerate.
EnumerationFlagHierarchyShallow

Devuelve el valor de la constante de enumeración EnumerationFlagHierarchyShallow para su uso en el parámetro flags del método IWSManSession::Enumerate.
EnumerationFlagNonXmlText

Devuelve el valor de la constante de enumeración WSManFlagNonXmlText para su uso en el parámetro flags del método IWSManSession::Enumerate.
EnumerationFlagReturnEPR

Devuelve el valor de la constante de enumeración EnumerationFlagReturnEPR para su uso en el parámetro flags del método IWSManSession::Enumerate.
EnumerationFlagReturnObject

Devuelve el valor de la constante de enumeración EnumerationFlagReturnObject para su uso en el parámetro flags del método IWSManSession::Enumerate.
EnumerationFlagReturnObjectAndEPR

Devuelve el valor de la constante de enumeración EnumerationFlagReturnObjectAndEPR para su uso en el parámetro flags del método IWSManSession::Enumerate.
Get

Recupera el recurso especificado por el URI y devuelve una representación XML de la instancia actual del recurso.
get_AtEndOfStream

Indica que se ha alcanzado el final de los elementos del objeto IWSManEnumerator mediante llamadas a IWSManEnumerator::ReadItem.
get_BatchItems

Establece y obtiene el número de elementos de cada lote de enumeración. (Obtener)
get_CertificateThumbprint

Establece u obtiene la huella digital del certificado que se va a usar al autenticarse mediante la autenticación de certificados de cliente. (Obtener)
get_CommandLine

Obtiene la línea de comandos del proceso que carga el componente de automatización.
get_Error

Obtiene información de error adicional, en una secuencia XML, para la llamada anterior a un método IWSMan si el servicio de administración remota de Windows no pudo crear un objeto IWSManSession, un objeto IWSManConnectionOptions o un objeto IWSManResourceLocator.
get_Error

Obtiene una representación XML de información de error adicional. (IWSManEnumerator.get_Error)
get_Error

Obtiene una representación XML de información de error adicional. (IWSManResourceLocator.get_Error)
get_Error

Obtiene información de error adicional en una secuencia XML para la llamada anterior a un método de objeto IWSManSession.
get_FragmentDialect

Obtiene o establece el dialecto de idioma de un dialecto de fragmento de recurso cuando se usa IWSManResourceLocator en métodos de objeto IWSManSession como Get, Put o Enumerate. (Obtener)
get_FragmentPath

Obtiene o establece la ruta de acceso de un fragmento de recurso o propiedad cuando se usa ResourceLocator en métodos de objeto IWSManSession, como Get, Put o Enumerate. (Obtener)
get_MustUnderstandOptions

Obtiene o establece el valor MustUnderstandOptions del objeto ResourceLocator. (Obtener)
get_ResourceURI

URI de recurso del recurso solicitado. Esta propiedad solo puede contener la ruta de acceso, no una cadena de consulta para instancias específicas. (Obtener)
get_Timeout

Establece y obtiene la cantidad máxima de tiempo, en milisegundos, que la aplicación cliente espera a que la administración remota de Windows complete sus operaciones. (Obtener)
get_UserName

Establece y obtiene el nombre de usuario de una cuenta de dominio o local en el equipo remoto. Esta propiedad determina el nombre de usuario para la autenticación. (Obtener)
GetErrorMessage

Devuelve una cadena con formato que contiene el texto de un número de error.
Identificar

Consulta un equipo remoto para determinar si admite el protocolo WS-Management.
Invocar

Invoca un método y devuelve los resultados de la llamada al método.
ProxyAuthenticationUseBasic

Devuelve el valor de la marca de autenticación de proxy WSManFlagProxyAuthenticationUseBasic para su uso en el parámetro authenticationMechanism del método IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseDigest

Devuelve el valor de la marca de autenticación de proxy WSManFlagProxyAuthenticationUseDigest para su uso en el parámetro authenticationMechanism del método IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseNegotiate

Devuelve el valor de la marca de autenticación de proxy WSManFlagProxyAuthenticationUseNegotiate para su uso en el parámetro authenticationMechanism del método IWSManConnectionOptionsEx2::SetProxy.
ProxyAutoDetect

Devuelve el valor de la marca de tipo de acceso de proxy WSManProxyAutoDetect para su uso en el parámetro accessType del método IWSManConnectionOptionsEx2::SetProxy.
ProxyIEConfig

Devuelve el valor de la marca de tipo de acceso de proxy WSManProxyIEConfig para su uso en el parámetro accessType del método IWSManConnectionOptionsEx2::SetProxy.
ProxyNoProxyServer

Devuelve el valor de la marca de tipo de acceso de proxy WSManProxyNoProxyServer para su uso en el parámetro accessType del método IWSManConnectionOptionsEx2::SetProxy.
ProxyWinHttpConfig

Devuelve el valor de la marca de tipo de acceso de proxy WSManProxyWinHttpConfig para su uso en el parámetro accessType del método IWSManConnectionOptionsEx2::SetProxy.
Poner

Actualiza un recurso.
put_BatchItems

Establece y obtiene el número de elementos de cada lote de enumeración. (Put)
put_CertificateThumbprint

Establece u obtiene la huella digital del certificado que se va a usar al autenticarse mediante la autenticación de certificados de cliente. (Put)
put_FragmentDialect

Obtiene o establece el dialecto de idioma de un dialecto de fragmento de recurso cuando se usa IWSManResourceLocator en métodos de objeto IWSManSession como Get, Put o Enumerate. (Put)
put_FragmentPath

Obtiene o establece la ruta de acceso de un fragmento de recurso o propiedad cuando se usa ResourceLocator en métodos de objeto IWSManSession, como Get, Put o Enumerate. (Put)
put_MustUnderstandOptions

Obtiene o establece el valor MustUnderstandOptions del objeto ResourceLocator. (Put)
put_Password

Establece la contraseña de una cuenta de dominio o local en el equipo remoto.
put_ResourceURI

URI de recurso del recurso solicitado. Esta propiedad solo puede contener la ruta de acceso, no una cadena de consulta para instancias específicas. (Put)
put_Timeout

Establece y obtiene la cantidad máxima de tiempo, en milisegundos, que la aplicación cliente espera a que la administración remota de Windows complete sus operaciones. (Put)
put_UserName

Establece y obtiene el nombre de usuario de una cuenta de dominio o local en el equipo remoto. Esta propiedad determina el nombre de usuario para la autenticación. (Put)
ReadItem

Recupera un elemento del recurso y devuelve una representación XML del elemento.
SessionFlagCredUsernamePassword

Devuelve el valor de la marca de autenticación WSManFlagCredUsernamePassword para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagEnableSPNServerPort

Devuelve el valor de la marca de autenticación WSManFlagEnableSPNServerPort para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagNoEncryption

Devuelve el valor de la marca de autenticación WSManFlagNoEncryption para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagSkipCACheck

Devuelve el valor de la marca de autenticación WSManFlagSkipCACheck para su uso en el parámetro flags del método IWSMan::CreateSession.
SessionFlagSkipCNCheck

Devuelve el valor de la marca de autenticación WSManFlagSkipCNCheck para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseBasic

Devuelve el valor de la marca de autenticación WSManFlagUseBasic para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseClientCertificate

Devuelve el valor de la marca de autenticación WSManFlagUseClientCertificate para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseCredSsp

Devuelve el valor de la marca de autenticación WSManFlagUseCredSsp para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseDigest

Devuelve el valor de la marca de autenticación WSManFlagUseDigest para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseKerberos

Devuelve el valor de la marca de autenticación WSManFlagUseKerberos para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseNegotiate

Devuelve el valor de la marca de autenticación WSManFlagUseNegotiate para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUseNoAuthentication

Devuelve el valor de la marca de autenticación WSManFlagUseNoAuthentication para su uso en el parámetro flags de IWSMan::CreateSession.
SessionFlagUTF8

Devuelve el valor de la marca de autenticación WSManFlagUTF8 para su uso en el parámetro flags de IWSMan::CreateSession.
SetProxy

Establece la información del proxy para la sesión.
WSMAN_PLUGIN_AUTHORIZE_OPERATION

Autoriza una operación específica.
WSMAN_PLUGIN_AUTHORIZE_QUERY_QUOTA

Recupera información de cuota para el usuario después de que se haya autorizado una conexión.
WSMAN_PLUGIN_AUTHORIZE_RELEASE_CONTEXT

Libera el contexto que informa un complemento de WSManPluginAuthzUserComplete o WSManPluginAuthzOperationComplete.
WSMAN_PLUGIN_AUTHORIZE_USER

Autoriza una conexión.
WSMAN_PLUGIN_COMMAND

Define la devolución de llamada del comando para un complemento.
WSMAN_PLUGIN_CONNECT

Define la devolución de llamada de conexión para un complemento.
WSMAN_PLUGIN_RECEIVE

Define la devolución de llamada de recepción de un complemento.
WSMAN_PLUGIN_RELEASE_COMMAND_CONTEXT

Define la devolución de llamada del comando release para el complemento.
WSMAN_PLUGIN_RELEASE_SHELL_CONTEXT

Define la devolución de llamada del shell de versión para el complemento.
WSMAN_PLUGIN_SEND

Define la devolución de llamada de envío para un complemento.
WSMAN_PLUGIN_SHELL

Define la devolución de llamada del shell para un complemento.
WSMAN_PLUGIN_SHUTDOWN

Define la devolución de llamada de apagado para el complemento.
WSMAN_PLUGIN_SIGNAL

Define la devolución de llamada de señal para un complemento.
WSMAN_PLUGIN_STARTUP

Define la devolución de llamada de inicio del complemento.
WSMAN_SHELL_COMPLETION_FUNCTION

Función de devolución de llamada a la que se llama para las operaciones de shell, lo que da lugar a una solicitud remota.
WSManCloseCommand

Elimina un comando y libera los recursos asociados a él.
WSManCloseOperation

Cancela o cierra una operación asincrónica.
WSManCloseSession

Cierra un objeto de sesión.
WSManCloseShell

Elimina un objeto de shell y libera los recursos asociados al shell.
WSManConnectShell

Se conecta a una sesión de servidor existente.
WSManConnectShellCommand

Se conecta a un comando existente que se ejecuta en un shell.
WSManCreateSession

Crea un objeto de sesión.
WSManCreateShell

Crea un objeto de shell.
WSManCreateShellEx

Crea un objeto de shell mediante la misma funcionalidad que la función WSManCreateShell, con la adición de un identificador de shell especificado por el cliente.
WSManDeinitialize

Desinicializa la pila de cliente de administración remota de Windows.
WSManDisconnectShell

Desconecta la conexión de red de un shell activo y sus comandos asociados.
WSManGetErrorMessage

Recupera los mensajes de error asociados a un error y códigos de idioma concretos.
WSManGetSessionOptionAsDword

Obtiene el valor de una opción de sesión. (WSManGetSessionOptionAsDword)
WSManGetSessionOptionAsString

Obtiene el valor de una opción de sesión. (WSManGetSessionOptionAsString)
WSManInitialize

Inicializa la API cliente de administración remota de Windows.
WSManPluginAuthzOperationComplete

Notifica una autorización correcta o errónea para una operación de usuario.
WSManPluginAuthzQueryQuotaComplete

Se llama desde el punto de entrada del complemento WSManPluginAuthzQueryQuota y se debe llamar a si el complemento puede llevar a cabo la solicitud o no.
WSManPluginAuthzUserComplete

Notifica una autorización de conexión de usuario correcta o errónea.
WSManPluginFreeRequestDetails

Libera memoria asignada para la estructura de WSMAN_PLUGIN_REQUEST, que se pasa a los puntos de entrada del complemento de operación.
WSManPluginGetOperationParameters

Obtiene información operativa de elementos como tiempos de espera y restricciones de datos asociados a la operación.
WSManPluginOperationComplete

Informa de la finalización de una operación por todos los puntos de entrada de la operación excepto para los métodos WSManPluginStartup y WSManPluginShutdown.
WSManPluginReceiveResult

Notifica los resultados de la llamada de complemento de WSMAN_PLUGIN_RECEIVE y lo usan la mayoría de los complementos de shell que devuelven resultados.
WSManPluginReportContext

Devuelve el contexto de comandos y shell a la infraestructura de Administración remota de Windows (WinRM) para que se puedan realizar más operaciones en el shell o comando.
WSManReceiveShellOutput

Recupera la salida de un comando en ejecución o del shell.
WSManReconnectShell

Vuelve a conectar una sesión de shell desconectada anteriormente. Para volver a conectar los comandos asociados de la sesión de shell, use WSManReconnectShellCommand.
WSManReconnectShellCommand

Vuelve a conectar un comando desconectado previamente.
WSManRunShellCommand

Inicia la ejecución de un comando dentro de un shell existente y no espera la finalización del comando.
WSManRunShellCommandEx

Proporciona la misma funcionalidad que la función WSManRunShellCommand, con la adición de una opción de identificador de comando.
WSManSendShellInput

Ipa el flujo de entrada a un comando en ejecución o al shell.
WSManSetSessionOption

Establece un conjunto extendido de opciones para la sesión.
WSManSignalShell

Envía un código de control a un comando existente o al propio shell.

Interfaces

 
IWSMan

Proporciona métodos y propiedades usados para crear una sesión, representada por un objeto Session.
IWSManConnectionOptions

El objeto IWSManConnectionOptions se pasa al método IWSMan::CreateSession para proporcionar el nombre de usuario y la contraseña asociados a la cuenta local en el equipo remoto.
IWSManConnectionOptionsEx

El objeto IWSManConnectionOptionsEx se pasa al método IWSMan::CreateSession para proporcionar la huella digital del certificado de cliente usado para la autenticación.
IWSManConnectionOptionsEx2

El objeto IWSManConnectionOptionsEx2 se pasa al método IWSMan::CreateSession para proporcionar el mecanismo de autenticación, el tipo de acceso y las credenciales para conectarse a un servidor proxy.
IWSManEnumerator

Representa una secuencia de resultados devueltos por operaciones como una operación WS-Enumeration:Enumerate del protocolo WS-Management.
IWSManEx

Extiende los métodos y propiedades de la interfaz IWSMan para incluir la creación de objetos IWSManResourceLocator, métodos que devuelven valores de enumeración y marca de sesión, y un método para obtener información de error extendida.
IWSManEx2

Extiende los métodos y propiedades de la interfaz IWSManEx para incluir un método que devuelve un valor de marca de sesión relacionado con la autenticación mediante certificados de cliente.
IWSManEx3

Extiende los métodos y las propiedades de la interfaz IWSManEx para incluir un método que devuelve un valor de marca de sesión relacionado con la autenticación mediante el proveedor de soporte técnico de seguridad de credenciales (CredSSP).
IWSManResourceLocator

Proporciona la ruta de acceso a un recurso. Puede usar un objeto IWSManResourceLocator en lugar de un URI de recurso en operaciones de objeto IWSManSession, como IWSManSession.Get, IWSManSession.Put o IWSManSession.Enumerate.
IWSManSession

Define las operaciones y la configuración de sesión.

Estructuras

 
WSMAN_AUTHENTICATION_CREDENTIALS

Define el método de autenticación y las credenciales usadas para la autenticación de servidor o proxy.
WSMAN_AUTHZ_QUOTA

Informa de la información de cuota por usuario para los complementos de autorización.
WSMAN_CERTIFICATE_DETAILS

Almacena información de cliente para una solicitud entrante que se envió con un certificado de cliente.
WSMAN_COMMAND_ARG_SET

Representa el conjunto de argumentos que se pasan a la línea de comandos.
WSMAN_DATA

Contiene datos entrantes y salientes usados en la API de Administración remota de Windows (WinRM).
WSMAN_DATA_BINARY

Contiene datos binarios para su uso con varias funciones de administración remota de Windows.
WSMAN_DATA_TEXT

Contiene datos textuales para su uso con varias funciones de administración remota de Windows.
WSMAN_ENVIRONMENT_VARIABLE

Define una variable de entorno individual mediante un par nombre y valor.
WSMAN_ENVIRONMENT_VARIABLE_SET

Define una matriz de variables de entorno.
WSMAN_ERROR

Contiene información de error que devuelve un cliente de Administración remota de Windows (WinRM).
WSMAN_FILTER

WSMAN_FILTER está reservado para uso futuro.
WSMAN_FRAGMENT

WSMAN_FRAGMENT está reservado para uso futuro.
WSMAN_KEY

Representa un par clave y valor dentro de un conjunto de selectores y se usa para identificar un recurso determinado.
WSMAN_OPERATION_INFO

Representa un punto de conexión de recurso específico para el que el complemento debe realizar la solicitud.
WSMAN_OPTION

Representa un par de valores y nombre de opción específicos.
WSMAN_OPTION_SET

Representa un conjunto de opciones.
WSMAN_PLUGIN_REQUEST

Especifica información para una solicitud de complemento.
WSMAN_PROXY_INFO

Especifica información de proxy.
WSMAN_RECEIVE_DATA_RESULT

Representa los datos de salida recibidos de un método WSManReceiveShellOutput.
WSMAN_RESPONSE_DATA

Representa los datos de salida recibidos de una operación WSMan.
WSMAN_SELECTOR_SET

Define un conjunto de claves que representan la identidad de un recurso.
WSMAN_SENDER_DETAILS

Especifica los detalles del cliente para cada solicitud entrante.
WSMAN_SHELL_ASYNC

Define una estructura asincrónica que se va a pasar a todas las operaciones de shell.
WSMAN_SHELL_DISCONNECT_INFO

Especifica la duración máxima, en milisegundos, el shell permanecerá abierto después de que el cliente se haya desconectado.
WSMAN_SHELL_STARTUP_INFO_V10

La estructura WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h) define los parámetros de inicio del shell que se usarán con la función WSManCreateShell.
WSMAN_SHELL_STARTUP_INFO_V11

La estructura WSMAN_SHELL_STARTUP_INFO_V11 (wsman.h) define los parámetros de inicio del shell que se usarán con la función WSManCreateShell.
WSMAN_STREAM_ID_SET

Enumera todas las secuencias que se usan para la entrada o salida para el shell y los comandos.
WSMAN_USERNAME_PASSWORD_CREDS

Define las credenciales usadas para la autenticación.