Get-WSManInstance

Módulo:

Microsoft.WSMan.Management

Muestra información de administración de una instancia de recurso especificada por un URI de recurso.

Sintaxis

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

El Get-WSManInstance cmdlet recupera una instancia de un recurso de administración especificado por un identificador uniforme de recursos (URI). La información que se recupera puede ser un conjunto de información XML complejo, que es un objeto o un valor simple. Este cmdlet es el equivalente al comando Get de servicios web estándar para administración (WS-Management).

Este cmdlet usa la capa de conexión/transporte de WS-Management para recuperar la información.

Ejemplos

Ejemplo 1: Obtener toda la información de WMI

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

Este comando devuelve toda la información que Windows Management Instrumentation (WMI) expone sobre el servicio WinRM en el equipo remoto server01.

Ejemplo 2: Obtención del estado del servicio Spooler

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

Este comando devuelve solo el estado del servicio Spooler en el equipo remoto server01.

Ejemplo 3: Obtener referencias de punto de conexión para todos los servicios

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

Este comando devuelve las referencias de extremo que se corresponden con todos los servicios en el equipo local.

Ejemplo 4: Obtener servicios que cumplen los criterios especificados

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

Este comando enumera todos los servicios que cumplen los siguientes criterios en el equipo remoto Server01:

• El tipo de inicio del servicio es Automático.
• El servicio está detenido.

Ejemplo 5: Obtener la configuración del agente de escucha que coincida con los criterios del equipo local

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

Este comando muestra la configuración de agente de escucha de WS-Management en el equipo local para el agente de escucha que coincide con los criterios en el conjunto de selector.

Ejemplo 6: Obtener la configuración del agente de escucha que coincida con los criterios de un equipo remoto

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

Este comando muestra la configuración de agente de escucha de WS-Management en el equipo remoto server01 para el agente de escucha que coincide con los criterios en el conjunto de selector.

Ejemplo 7: Obtención de instancias asociadas relacionadas con una instancia especificada

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

Este comando obtiene las instancias asociadas que están relacionadas con la instancia especificada (winrm).

el filtro debe incluirse entre comillas, como se muestra en el ejemplo.

Ejemplo 8: Obtención de instancias de asociación relacionadas con una instancia especificada

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

Este comando obtiene las instancias de asociación que están relacionadas con la instancia especificada (winrm). Dado que el valor dialecto es asociación y se usa el parámetro Associations, este comando devuelve instancias de asociación, no instancias asociadas.

el filtro debe incluirse entre comillas, como se muestra en el ejemplo.

Parámetros

-ApplicationName

Especifica el nombre de la aplicación en la conexión. El valor predeterminado del parámetro ApplicationName es WSMAN. El identificador completo para el extremo remoto está en el formato siguiente:

<transport>://<server>:<port>/<ApplicationName>

Por ejemplo: http://server01:8080/WSMAN

Internet Information Services (IIS), que hospeda la sesión, reenvía las solicitudes con este extremo a la aplicación especificada. Esta configuración predeterminada de WSMAN es adecuada para la mayoría de los usos. Este parámetro está diseñado para usarse si muchos equipos establecen conexiones remotas a un equipo que ejecuta PowerShell. En este caso, IIS hospeda WS-Management para mejorar la eficacia.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Associations

Indica que este cmdlet obtiene instancias de asociación, no instancias asociadas. Puede usar este parámetro solo cuando el parámetro Dialect tiene un valor de Association.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Authentication

Especifica el mecanismo de autenticación que se va a usar en el servidor. Los valores permitidos para este parámetro son los siguientes:

• Basic - Básico es un esquema en el que el nombre de usuario y la contraseña se envían en texto no cifrado al servidor o proxy.
• Default - Use el método de autenticación implementado por el protocolo WS-Management. Este es el valor predeterminado.
• Digest - Resumen es un esquema de desafío-respuesta que usa una cadena de datos especificada por el servidor para el desafío.
• Kerberos - El equipo cliente y el servidor se autentican mutuamente mediante certificados Kerberos.
• Negotiate - Negotiate es un esquema de desafío-respuesta que negocia con el servidor o proxy para determinar el esquema que se va a usar para la autenticación. Por ejemplo, este valor de parámetro permite que la negociación determine si se usa el protocolo Kerberos o NTLM.
• CredSSP - Use la autenticación del proveedor de soporte técnico de seguridad de credenciales (CredSSP), que permite al usuario delegar las credenciales. Esta opción está diseñada para comandos que se ejecuten en un equipo remoto pero que recopilen datos o ejecuten comandos adicionales en otros equipos remotos.

Precaución

CredSSP delega las credenciales de usuario del equipo local a un equipo remoto. Este procedimiento aumenta el riesgo de seguridad de la operación remota. Si el equipo remoto ve su seguridad comprometida, al pasar al equipo las credenciales, estas pueden utilizarse para controlar la sesión de red.

Tipo:	AuthenticationMechanism
Alias:	auth, am
Valores aceptados:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BasePropertiesOnly

Indica que este cmdlet enumera solo las propiedades que forman parte de la clase base especificada por el parámetro ResourceURI . Este parámetro no tiene ningún efecto si se especifica el parámetro Superficial .

Tipo:	SwitchParameter
Alias:	UBPO, Base
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CertificateThumbprint

Especifica el certificado de clave pública digital (X509) de una cuenta de usuario que tiene permiso para realizar esta acción. Escriba la huella digital del certificado.

Los certificados se usan para la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales y no funcionan con cuentas de dominio.

Para obtener una huella digital de certificado, use el Get-Item comando o Get-ChildItem en la unidad Cert: de PowerShell.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ComputerName

Especifica el equipo en el que se va a ejecutar la operación de administración. El valor puede ser un nombre de dominio completo, un nombre NetBIOS o una dirección IP. Use el nombre del equipo local, use localhost o use un punto (.) para especificar el equipo local. El valor predeterminado es el equipo local. Si el equipo remoto está en un dominio distinto al del usuario, se deberá usar el nombre de dominio completo. Se puede canalizar un valor para este parámetro al cmdlet.

Tipo:	String
Alias:	CN
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ConnectionURI

Especifica el extremo de la conexión. El formato de esta cadena es:

<Transport>://<Server>:<Port>/<ApplicationName>

La cadena siguiente es un valor con formato correcto para este parámetro:

http://Server01:8080/WSMAN

El identificador URI debe ser completo.

Tipo:	Uri
Alias:	CURI, CU
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual. Escriba un nombre de usuario, como User01, Domain01\User01 o User@Domain.com. O bien, escriba un objeto PSCredential , como uno devuelto por el Get-Credential cmdlet . Al escribir un nombre de usuario, este cmdlet le pedirá una contraseña.

Tipo:	PSCredential
Alias:	cred, c
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Dialect

Especifica el dialecto que se usará en el predicado de filtro. Puede ser cualquier dialecto admitido por el servicio remoto. Pueden utilizarse los siguientes alias para el URI de dialecto:

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Selector- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Asociación- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Tipo:	Uri
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Enumerate

Indica que este cmdlet devuelve todas las instancias de un recurso de administración.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Filter

Especifica la expresión de filtro para la enumeración. Si especifica este parámetro, también debe especificar Dialecto.

Los valores válidos de este parámetro dependen del dialecto especificado en Dialecto. Por ejemplo, si Dialect es WQL, el parámetro Filter debe contener una cadena y la cadena debe contener una consulta WQL válida, como la siguiente:

"Select * from Win32_Service where State != Running"

Si Dialecto es Association, Filter debe contener una cadena y la cadena debe contener un filtro válido, como el siguiente filtro:

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Fragment

Especifica una sección dentro de la instancia que se va a actualizar o a recuperar para la operación especificada. Por ejemplo, para obtener el estado de un servicio de cola, especifique lo siguiente:

-Fragment Status

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OptionSet

Especifica un conjunto de modificadores a un servicio para modificar o refinar la naturaleza de la solicitud. Estos modificadores se asemejan a los que se usan en los shells de línea de comandos porque son específicos del servicio. Se pueden especificar tantas opciones como sea necesario.

En el siguiente ejemplo se muestra la sintaxis que pasa los valores 1, 2 y 3 a los parámetros a, b y c:

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

Tipo:	Hashtable
Alias:	OS
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Port

Especifica el puerto que se utilizará cuando el cliente se conecte al servicio WinRM. Si el transporte es HTTP, el puerto predeterminado es 80. Si el transporte es HTTPS, el puerto predeterminado es 443.

Cuando se usa HTTPS como transporte, el valor del parámetro ComputerName debe coincidir con el nombre común (CN) del certificado del servidor. Sin embargo, si el parámetro SkipCNCheck se especifica como parte del parámetro SessionOption , el nombre común del certificado del servidor no tiene que coincidir con el nombre de host del servidor. El parámetro SkipCNCheck solo debe usarse para equipos de confianza.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceURI

Especifica el URI de la clase o instancia de recursos. El URI identifica un tipo específico de recurso, como discos o procesos, en un equipo.

Un URI consta de un prefijo y una ruta de acceso de un recurso. Por ejemplo:

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
Alias:	RURI
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ReturnType

Especifica el tipo de datos que se va a devolver. Los valores permitidos para este parámetro son los siguientes:

• Object
• EPR
• ObjectAndEPR

El valor predeterminado es Object.

Si especifica o no especifica Object este parámetro, este cmdlet devuelve solo objetos. Si especifica la referencia de punto de conexión (EPR), este cmdlet devuelve solo las referencias de punto de conexión de los objetos. Las referencias de extremo contienen información sobre el identificador URI de recurso y los selectores de la instancia. Si especifica ObjectAndEPR, este cmdlet devuelve tanto el objeto como sus referencias de punto de conexión asociadas.

Tipo:	String
Alias:	RT
Valores aceptados:	object, epr, objectandepr
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SelectorSet

Especifica un conjunto de pares de valores que se usan para seleccionar determinadas instancias de recursos de administración. El parámetro SelectorSet se usa cuando existe más de una instancia del recurso. El valor del parámetro SelectorSet debe ser una tabla hash.

En el siguiente ejemplo se muestra cómo escribir un valor para este parámetro:

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

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SessionOption

Especifica las opciones extendidas para la sesión de WS-Management. Escriba un objeto SessionOption que cree mediante el cmdlet New-WSManSessionOption. Para obtener más información sobre las opciones disponibles, escriba Get-Help New-WSManSessionOption.

Tipo:	SessionOption
Alias:	SO
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Shallow

Indica que este cmdlet devuelve solo instancias de la clase base especificada en el URI del recurso. Si no especifica este parámetro, este cmdlet devuelve instancias de la clase base especificada en el URI y en todas sus clases derivadas.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseSSL

Especifica que el protocolo Capa de sockets seguros (SSL) se usa para establecer una conexión con el equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de Windows PowerShell que se transmite a través de la red. El parámetro UseSSL permite especificar la protección adicional de HTTPS en lugar de HTTP. Si SSL no está disponible en el puerto que se usa para la conexión y especifica este parámetro, se produce un error en el comando.

Tipo:	SwitchParameter
Alias:	SSL
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

XmlElement

Este cmdlet devuelve un objeto XMLElement .

Vínculos 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