Get-CimAssociatedInstance

Syntaxe

ComputerSet (Par défaut)

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

SessionSet

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

Description

Exemples

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

PS C:\>$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly

PS C:\>Get-CimAssociatedInstance -InputObject $disk[1]

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

PS C:\>$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly

PS C:\>Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition

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

PS C:\>$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"

PS C:\>Get-CimClass -ClassName *Service* -Qualifier "Association"

PS C:\>$c.CimClasName
Win32_LoadOrderGroupServiceDependencies
Win32_DependentService
Win32_SystemServices
Win32_LoadOrderGroupServiceMembers
Win32_ServiceSpecificationService

PS C:\>Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

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 quel que soit leur type.

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.

Propriétés du paramètre

Jeux de paramètres

-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_CimSessions.

Propriétés du paramètre

Jeux de paramètres

-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.

Propriétés du paramètre

Jeux de paramètres

-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.

Propriétés du paramètre

Jeux de paramètres

-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.

Propriétés du paramètre

Jeux de paramètres

-Namespace

Spécifie l’espace de noms de l’opération CIM.

L’espace de noms par défaut est racine/cimv2.

Propriétés du paramètre

Jeux de paramètres

-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.

Propriétés du paramètre

Jeux de paramètres

-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 spécifique de ressource, tel que des disques ou des processus, sur un ordinateur.

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

• https://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 de ressource standard DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ 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é.

Propriétés du paramètre

Jeux de paramètres

-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, ce qui signifie que 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).

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

None

Sorties

Object

Liens associés

• Get-CimClass
• Get-CimInstance