Get-CimAssociatedInstance
Récupère les instances CIM connectées à une instance CIM spécifique par une association.
Syntaxe
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
L’applet Get-CimAssociatedInstance
de commande récupère les instances CIM connectées à une instance CIM spécifique, appelée instance source, par une association.
Dans une association, chaque instance CIM a un rôle nommé et la même instance CIM peut participer à une association dans différents rôles.
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 une session WMI (Windows Management Instrumentation) locale à l’aide d’une session COM (Component Object Model).
- Si le paramètre ComputerName ou le paramètre CimSession est spécifié, cette applet de commande fonctionne sur le serveur CIM spécifié par le paramètre ComputerName ou le paramètre CimSession.
Exemples
Exemple 1 : Obtenir toutes les instances associées d’une 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 Get-CimInstance
de commande. La première instance de disque logique de la variable est ensuite utilisée comme objet d’entrée pour l’applet Get-CimAssociatedInstance
de commande afin d’obtenir toutes les instances CIM associées de l’instance CIM spécifiée.
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
. La première instance de disque logique de la variable est ensuite utilisée comme objet d’entrée pour l’applet Get-CimAssociatedInstance
de commande pour 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 un qualificateur d’une classe spécifique
Cet ensemble de commandes récupère les services qui dépendent du service Winmgmt et les stocke dans une variable nommée $s
. Get-CimAssociatedInstance
obtient les instances associées de la classe d’association récupérée.
$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
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 d’un type quelconque.
Par exemple, si la classe A est associée à la classe B via 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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, par New-CimSession
Get-CimSession
exemple. Pour plus d’informations, consultez about_CimSession.
Type: | CimSession[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 objet de composant (COM).
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[] |
Alias: | CN, ServerName |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-InputObject
Spécifie l’entrée de cette applet de commande. Vous pouvez utiliser ce paramètre ou diriger l’entrée vers cette applet de commande.
Le paramètre InputObject n’énumère pas les collections. Si une collection est passée, une erreur est levée. Lorsque vous utilisez des collections, dirigez l’entrée pour énumérer les valeurs.
Type: | CimInstance |
Alias: | CimInstance |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-KeyOnly
Retourne des objets avec uniquement les 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Namespace
Spécifie l’espace de noms de l’opération CIM. L’espace de noms par défaut est racine/cimv2.
Remarque
Vous pouvez utiliser la saisie semi-automatique des onglets 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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’attente de nouvelle tentative de connexion robuste de 3 minutes, les échecs 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 |
Alias: | OT |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceUri
Spécifie l’URI (Uniform Resource Identifier) de la classe de ressource ou de l’instance. 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 est ajouté à celui-ci.
ResourceURI peut uniquement être utilisé avec des 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ResultClassName
Spécifie le nom de classe des instances associées. Une instance CIM peut être associée à 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 restreindre la sortie à un type spécifique (B, C ou D).
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
Cette applet de commande retourne un objet d’instance CIM.
Notes
Windows PowerShell inclut les alias suivants pour Get-CimAssociatedInstance
:
gcai