Partager via

Get-CimAssociatedInstance

  • Référence
Module:
CimCmdlets

Récupère les instances CIM connectées à un instance CIM spécifique par une association.

Syntax

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

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Get-CimAssociatedInstance de commande récupère les instances CIM connectées à un instance CIM spécifique, appelé instance source, par une association.

Dans une association, chaque instance CIM a un rôle nommé et le même instance CIM peut participer à une association dans des rôles différents.

Si le paramètre InputObject n’est pas spécifié, l’applet de commande fonctionne de l’une des manières suivantes :

  • Si ni le paramètre ComputerName ni le paramètre CimSession ne sont spécifiés, cette applet de commande fonctionne sur windows Management Instrumentation (WMI) local à l’aide d’une session COM (Component Object Model).
  • Si le paramètre ComputerName ou cimSession est spécifié, cette applet de commande fonctionne sur le serveur CIM spécifié par le paramètre ComputerName ou cimSession .

Exemples

Exemple 1 : Obtenir toutes les instances associées d’un instance spécifique

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

Cet ensemble de commandes récupère les instances de la classe nommée Win32_LogicalDisk et stocke les informations dans une variable nommée $disk à l’aide de l’applet de Get-CimInstance commande. Le premier disque logique instance dans la variable est ensuite utilisé comme objet d’entrée pour l’applet Get-CimAssociatedInstance de commande afin d’obtenir toutes les instances CIM associées du instance CIM spécifié.

Exemple 2 : Obtenir toutes les instances associées d’un type spécifique

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

Cet ensemble de commandes récupère toutes les instances de la classe Win32_LogicalDisk et les stocke dans une variable nommée $disk. Le premier disque logique instance dans la variable est ensuite utilisé comme objet d’entrée pour l’applet Get-CimAssociatedInstance de commande afin d’obtenir toutes les instances associées associées via la classe d’association spécifiée Win32_DiskPartition.

Exemple 3 : Obtenir toutes les instances associées via le qualificateur d’une classe spécifique

$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
Get-CimClass -ClassName *Service* -Qualifier "Association"
$c.CimClasName

Win32_LoadOrderGroupServiceDependencies
Win32_DependentService
Win32_SystemServices
Win32_LoadOrderGroupServiceMembers
Win32_ServiceSpecificationService

Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

Cet ensemble de commandes récupère les services qui dépendent du service WMI et les stocke dans une variable nommée $s. Le nom de la classe d’association du Win32_DependentService est récupéré à l’aide de l’applet Get-CimClass de commande en spécifiant Association comme qualificateur, puis est passé avec $s à l’applet Get-CimAssociatedInstance de commande pour obtenir toutes les instances associées de la classe d’association récupérée.

Paramètres

-Association

Spécifie le nom de la classe d’association. Si vous ne spécifiez pas ce paramètre, l’applet de commande retourne tous les objets d’association existants de n’importe quel type.

Par exemple, si la classe A est associée à la classe B par le biais de deux associations, AB1 et AB2, ce paramètre peut être utilisé pour spécifier le type d’association, AB1 ou AB2.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CimSession

Exécute la commande à l’aide de la session CIM spécifiée. Entrez une variable qui contient la session CIM, ou une commande qui crée ou obtient la session CIM, telle que New-CimSession ou Get-CimSession. Pour plus d’informations, consultez about_CimSession.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Spécifie le nom de l’ordinateur sur lequel vous souhaitez exécuter l’opération CIM. Vous pouvez spécifier un nom de domaine complet (FQDN) ou un nom NetBIOS.

Si vous spécifiez ce paramètre, l’applet de commande crée une session temporaire sur l’ordinateur spécifié à l’aide du protocole WsMan.

Si vous ne spécifiez pas ce paramètre, l’applet de commande effectue l’opération sur l’ordinateur local à l’aide du modèle COM (Component Object Model).

Si plusieurs opérations sont effectuées sur le même ordinateur, la connexion à l’aide d’une session CIM offre de meilleures performances.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifie l'entrée de cette applet de commande. Vous pouvez utiliser ce paramètre ou vous adresser l'entrée à cette applet de commande.

Le paramètre InputObject n’énumère pas les collections. Si une collection est transmise, une erreur est générée. Lorsque vous travaillez avec des collections, canalisez l’entrée pour énumérer les valeurs.

Type:CimInstance
Aliases:CimInstance
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyOnly

Retourne des objets avec uniquement des propriétés de clé renseignées. Cela réduit la quantité de données transférées sur le réseau.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Spécifie l’espace de noms pour l’opération CIM. L’espace de noms par défaut est root/cimv2.

Notes

Vous pouvez utiliser la saisie semi-automatique d’onglet pour parcourir la liste des espaces de noms, car PowerShell obtient une liste d’espaces de noms à partir du serveur WMI local pour fournir la liste des espaces de noms.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Spécifie la durée pendant laquelle l’applet de commande attend une réponse de l’ordinateur. Par défaut, la valeur de ce paramètre est 0, ce qui signifie que l’applet de commande utilise la valeur de délai d’expiration par défaut pour le serveur.

Si le paramètre OperationTimeoutSec est défini sur une valeur inférieure au délai d’expiration des nouvelles tentatives de connexion robuste de 3 minutes, les défaillances réseau qui durent plus que la valeur du paramètre OperationTimeoutSec ne sont pas récupérables, car l’opération sur le serveur expire avant que le client puisse se reconnecter.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceUri

Spécifie l’URI (Uniform Resource Identifier) de la classe de ressources ou de l’instance de ressources. L'URI est utilisé pour identifier un type particulier de ressource, comme un disque ou un processus, sur un ordinateur.

Un URI se compose d'un préfixe et d'un chemin d'accès à une ressource. Par exemple :

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

Par défaut, si vous ne spécifiez pas ce paramètre, l’URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ de ressource standard DMTF est utilisé et le nom de la classe y est ajouté.

ResourceURI ne peut être utilisé qu’avec les sessions CIM créées à l’aide du protocole WSMan ou lors de la spécification du paramètre ComputerName , qui crée une session CIM à l’aide de WSMan. Si vous spécifiez ce paramètre sans spécifier le paramètre ComputerName ou si vous spécifiez une session CIM créée à l’aide du protocole DCOM, vous obtenez une erreur, car le protocole DCOM ne prend pas en charge le paramètre ResourceURI .

Si le paramètre ResourceUri et le paramètre Filter sont spécifiés, le paramètre Filter est ignoré.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResultClassName

Spécifie le nom de classe des instances associées. Un instance CIM peut être associé à une ou plusieurs instances CIM. Toutes les instances CIM associées sont retournées si vous ne spécifiez pas le nom de la classe de résultat.

Par défaut, la valeur de ce paramètre est null et toutes les instances CIM associées sont retournées.

Vous pouvez filtrer les résultats de l’association pour qu’ils correspondent à un nom de classe spécifique. Le filtrage se produit sur le serveur. Si ce paramètre n’est pas spécifié, Get-CIMAssociatedInstance retourne toutes les associations existantes. Par exemple, si la classe A est associée aux classes B, C et D, ce paramètre peut être utilisé pour limiter la sortie à un type spécifique (B, C ou D).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Cette applet de commande n’accepte aucun objet d’entrée.

Sorties

Object

Cette applet de commande retourne un objet.