Búsqueda de sitios web

Obtener-CimAssociatedInstance (CimCmdlets)

Obtener-CimAssociatedInstance

Módulo:
CimCmdlets

Recupera las instancias CIM que están conectadas a una instancia CIM específica mediante una asociación.

Sintaxis

Get-CimAssociatedInstance
   [[-Association] <String>]
   [-ResultClassName <String>]
   [-InputObject] <CimInstance>
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-ResourceUri <Uri>]
   [-ComputerName <String[]>]
   [-KeyOnly]
   [<CommonParameters>]
Get-CimAssociatedInstance
   [[-Association] <String>]
   [-ResultClassName <String>]
   [-InputObject] <CimInstance>
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-ResourceUri <Uri>]
   -CimSession <CimSession[]>
   [-KeyOnly]
   [<CommonParameters>]

Descripción

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Get-CimAssociatedInstance recupera las instancias CIM conectadas a una instancia CIM específica, denominada instancia de origen, mediante una asociación.

En una asociación, cada instancia de CIM tiene una función designada y la misma instancia de CIM puede participar en una asociación en diferentes funciones.

Si no se especifica el parámetro InputObject, el cmdlet funciona de una de las siguientes maneras:

  • Si no se especifica ni el parámetro ComputerName ni el parámetro CimSession, este cmdlet funciona en el Instrumental de administración de Windows (WMI) local mediante una sesión del Modelo de objetos componentes (COM).
  • Si se especifica el parámetro ComputerName o el parámetro CimSession, este cmdlet funciona con el servidor CIM especificado por el parámetro ComputerName o el < parámetroCimSession.

Ejemplos

Ejemplo 1: obtener todas las instancias asociadas de una instancia específica

$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]

Este conjunto de comandos recupera las instancias de la clase denominada Win32_LogicalDisk y almacena la información en una variable denominada $disk mediante el cmdlet Get-CimInstance. Luego, la primera instancia de disco lógico en la variable se usa como objeto de entrada para el cmdlet Get-CimAssociatedInstance para obtener todas las instancias CIM asociadas de la instancia CIM especificada.

Ejemplo 2: obtener todas las instancias asociadas de un tipo específico

$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition

Este conjunto de comandos recupera todas las instancias de la clase Win32_LogicalDisk y las almacena en una variable denominada $disk. Luego, la primera instancia de disco lógico en la variable se usa como objeto de entrada para el cmdlet Get-CimAssociatedInstance para obtener todas las instancias asociadas a través de la clase de asociación especificada Win32_DiskPartition. .

Ejemplo 3: obtener todas las instancias asociadas a través del calificador de una clase específica

Este conjunto de comandos recupera los servicios que dependen del servicio Winmgmt y los almacena en una variable denominada $s. Get-CimAssociatedInstance obtiene las instancias asociadas de la clase de asociación recuperada.

$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

ProcessId Name            StartMode State   Status ExitCode
--------- ----            --------- -----   ------ --------
1716      RpcSs           Auto      Running OK     0
9964      CcmExec         Auto      Running OK     0
0         HgClientService Manual    Stopped OK     1077
0         smstsmgr        Manual    Stopped OK     1077
3396      vmms            Auto      Running OK     0

Parámetros

-Association

Especifica el nombre de la clase de asociación. Si no especifica este parámetro, el cmdlet devuelve todos los objetos de asociación existentes de cualquier tipo.

Por ejemplo, si la clase A está asociada con la clase B a través de dos asociaciones, AB1 y AB2, entonces este parámetro se puede utilizar para especificar el tipo de asociación, ya sea AB1 o AB2.

Tipo :

String

Posición:

1

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-CimSession

Ejecuta el comando utilizando la sesión CIM especificada. Introduzca una variable que contenga la sesión CIM o un comando que cree u obtenga la sesión CIM, como New-CimSession o Get-CimSession. Para obtener más información, consulte about_CimSession.

Tipo :

Sesión cim[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-ComputerName

Especifica el nombre de la computadora en la que desea ejecutar la operación CIM. Puede especificar un nombre de dominio completo (FQDN) o un nombre NetBIOS.

Si especifica este parámetro, el cmdlet crea una sesión temporal en la computadora especificada mediante el protocolo WsMan.

Si no especifica este parámetro, el cmdlet realiza la operación en la computadora local mediante el modelo de objetos componentes (COM).

Si se realizan varias operaciones en la misma computadora, conectarse mediante una sesión CIM proporciona un mejor rendimiento.

Tipo :

String[]

Alias:

CN, ServerName

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-InputObject

Especifica la entrada a este cmdlet. Puede usar este parámetro o canalizar la entrada a este cmdlet.

El parámetro InputObject no enumera colecciones. Si se pasa una colección, se genera un error. Cuando trabaje con colecciones, canalice la entrada para enumerar los valores.

Tipo :

CimInstance

Alias:

CimInstance

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-KeyOnly

Devuelve objetos con solo propiedades clave completadas. Esto reduce la cantidad de datos que se transfieren a través de la red.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Namespace

Especifica el espacio de nombres para la operación CIM. El espacio de nombres predeterminado es root/cimv2.

Nota

Puede utilizar la función de tabulación para examinar la lista de espacios de nombres, porque PowerShell obtiene una lista de espacios de nombres del servidor WMI local para proporcionar la lista de espacios de nombres.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-OperationTimeoutSec

Especifica la cantidad de tiempo que el cmdlet espera una respuesta de la computadora. De forma predeterminada, el valor de este parámetro es 0, lo que significa que el cmdlet usa el valor de tiempo de espera predeterminado para el servidor.

Si el parámetro OperationTimeoutSec se establece en un valor menor que el tiempo de espera de reintento de conexión robusta de 3 minutos, las fallas de red que duran más que el valor del parámetro OperationTimeoutSec no son recuperables. , porque la operación en el servidor expira antes de que el cliente pueda volver a conectarse.

Tipo :

UInt32

Alias:

OT

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-ResourceUri

Especifica el identificador uniforme de recursos (URI) de la clase o instancia de recurso. El URI se utiliza para identificar un tipo específico de recurso, como discos o procesos, en una computadora.

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

    http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
    http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

De forma predeterminada, si no especifica este parámetro, se utiliza el URI de recurso estándar DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ y el se le añade el nombre de la clase.

ResourceURI solo se puede usar con sesiones CIM creadas usando el protocolo WSMan, o cuando se especifica el parámetro ComputerName, que crea una sesión CIM usando WSMan. Si especifica este parámetro sin especificar el parámetro ComputerName, o si especifica una sesión CIM creada utilizando el protocolo DCOM, obtendrá un error, porque el protocolo DCOM no admite el ResourceURI. fuerte> parámetro.

Si se especifican tanto el parámetro ResourceUri como el parámetro Filter, el parámetro Filter se ignora.

Tipo :

uri

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ResultClassName

Especifica el nombre de clase de las instancias asociadas. Una instancia CIM se puede asociar con una o más instancias CIM. Todas las instancias CIM asociadas se devuelven si no especifica el nombre de la clase de resultado.

De forma predeterminada, el valor de este parámetro es nulo y se devuelven todas las instancias CIM asociadas.

Puede filtrar los resultados de la asociación para que coincidan con un nombre de clase específico. El filtrado ocurre en el servidor. Si no se especifica este parámetro, Get-CIMAssociatedInstance devuelve todas las asociaciones existentes. Por ejemplo, si la clase A está asociada con las clases B, C y D, entonces este parámetro se puede usar para restringir la salida a un tipo específico (B, C o D).

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Ninguno

No puede canalizar objetos a este cmdlet.

Salidas

Instancia Cim

Este cmdlet devuelve un objeto de instancia CIM.

Notas

PowerShell incluye los siguientes alias para Get-CimAssociatedInstance:

  • Windows:

      gcai

Este cmdlet solo está disponible en plataformas Windows.