Compartir a través de

Get-CimAssociatedInstance

  • Referencia
Módulo:
CimCmdlets

Recupera las instancias CIM que están conectadas a una instancia CIM específica por 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>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

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

En una asociación, cada instancia cim tiene un rol con nombre y la misma instancia CIM puede participar en una asociación en distintos roles.

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

  • Si no se especifica el parámetro ComputerName ni el parámetro CimSession , este cmdlet funciona en la sesión local de Instrumental de administración de Windows (WMI) 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ámetro CimSession.

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 Get-CimInstance cmdlet . A continuación, la primera instancia de disco lógico de la variable se usa como objeto de entrada para el Get-CimAssociatedInstance cmdlet 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. A continuación, la primera instancia de disco lógico de la variable se usa como objeto de entrada para el Get-CimAssociatedInstance cmdlet para obtener todas las instancias asociadas asociadas a través de la clase de asociación especificada Win32_DiskPartition.

Ejemplo 3: Obtención de 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 a la clase B a través de dos asociaciones, AB1 y AB2, este parámetro se puede usar 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 mediante la sesión CIM especificada. Escriba una variable que contenga la sesión CIM o un comando que cree o obtenga la sesión CIM, como New-CimSession o Get-CimSession. Para obtener más información, consulte about_CimSession.

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

-ComputerName

Especifica el nombre del equipo en el 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 el equipo especificado mediante el protocolo WsMan.

Si no especifica este parámetro, el cmdlet realiza la operación en el equipo local mediante component Object Model (COM).

Si se realizan varias operaciones en el mismo equipo, la conexión mediante una sesión CIM proporciona un mejor rendimiento.

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

-InputObject

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

El parámetro InputObject no enumera las colecciones. Si se pasa una colección, se produce un error. Al trabajar 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 de clave rellenadas. Esto reduce la cantidad de datos que se transfieren a través de la red.

Tipo:SwitchParameter
Posición:Named
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 usar la finalización de tabulación para examinar la lista de espacios de nombres, ya que PowerShell obtiene una lista de espacios de nombres del servidor WMI local para proporcionar la lista de espacios de nombres.

Tipo:String
Posición:Named
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 del equipo. 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 sólido de 3 minutos, los errores de red que duran más que el valor del parámetro OperationTimeoutSec no se pueden recuperar, ya que la operación en el servidor agota el tiempo de espera antes de que el cliente pueda volver a conectarse.

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

-ResourceUri

Especifica el identificador uniforme de recursos (URI) del recurso de la clase o instancia de recursos. El URI se usa para identificar un tipo de recurso en un equipo, como discos o procesos.

Un URI consta de un prefijo y una ruta de acceso 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 usa el URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ del recurso estándar DMTF y el nombre de clase se anexa a él.

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

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

Tipo:Uri
Posición:Named
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 a una o varias instancias CIM. Se devuelven todas las instancias CIM asociadas si no especifica el nombre de la clase de resultado.

De forma predeterminada, el valor de este parámetro es NULL 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 se produce 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 a las clases B, C y D, este parámetro se puede usar para restringir la salida a un tipo específico (B, C o D).

Tipo:String
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

CimInstance

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.