Get-CimAssociatedInstance

Sintaxe

ComputerSet (Predefinição)

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

Exemplos

Exemplo 1: Obter todas as instâncias associadas de uma instância específica

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

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

Exemplo 2: Obter todas as instâncias associadas de um tipo específico

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

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

Exemplo 3: Obter todas as instâncias associadas por meio do qualificador de uma classe específica

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

Parâmetros

-Association

Especifica o nome da classe de associação.

Se você não especificar esse parâmetro, o cmdlet retornará todos os objetos de associação existentes, independentemente de seu tipo.

Por exemplo, se a classe A estiver associada à classe B através de duas associações, AB1 e AB2, então este parâmetro pode ser usado para especificar o tipo de associação, AB1 ou AB2.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CimSession

Executa o comando usando a sessão CIM especificada. Insira uma variável que contenha a sessão CIM ou um comando que crie ou obtenha a sessão CIM, como New-CimSession ou Get-CimSession. Para obter mais informações, consulte about_CimSessions.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ComputerName

Especifica o nome do computador no qual você deseja executar a operação CIM. Você pode especificar um nome de domínio totalmente qualificado (FQDN) ou um nome NetBIOS.

Se você especificar esse parâmetro, o cmdlet criará uma sessão temporária para o computador especificado usando o protocolo WsMan.

Se você não especificar esse parâmetro, o cmdlet executará a operação no computador local usando o COM (Component Object Model).

Se várias operações estiverem sendo executadas no mesmo computador, a conexão usando uma sessão CIM proporcionará um melhor desempenho.

Propriedades dos parâmetros

Conjuntos de parâmetros

-InputObject

Especifica a entrada para este cmdlet. Você pode usar esse parâmetro ou canalizar a entrada para esse cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-KeyOnly

Retorna objetos com apenas propriedades de chave preenchidas.

Isso reduz a quantidade de dados transferidos pela rede.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Namespace

Especifica o namespace para a operação CIM.

O namespace padrão é root/cimv2.

Propriedades dos parâmetros

Conjuntos de parâmetros

-OperationTimeoutSec

Especifica a quantidade de tempo que o cmdlet aguarda por uma resposta do computador.

Por padrão, o valor desse parâmetro é 0, o que significa que o cmdlet usa o valor de tempo limite padrão para o servidor.

Se o parâmetro OperationTimeoutSec for definido como um valor menor que o tempo limite de repetição de conexão robusto de 3 minutos, as falhas de rede que duram mais do que o valor do parâmetro OperationTimeoutSec não serão recuperáveis, porque a operação no servidor expira antes que o cliente possa se reconectar.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceUri

Especifica o URI (identificador uniforme de recurso) da classe ou instância do recurso. O URI é usado para identificar um tipo específico de recurso, como discos ou processos, em um computador.

Um URI consiste em um prefixo e um caminho para um recurso. Por exemplo:

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

Por padrão, se você não especificar esse parâmetro, o http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ URI de recurso padrão DMTF será usado e o nome da classe será anexado a ele.

ResourceURI só pode ser usado com sessões CIM criadas usando o protocolo WSMan ou ao especificar o parâmetro ComputerName, que cria uma sessão CIM usando WSMan. Se você especificar esse parâmetro sem especificar o parâmetro ComputerName ou se especificar uma sessão CIM criada usando o protocolo DCOM, obterá um erro, porque o protocolo DCOM não suporta o parâmetro ResourceURI.

Se o parâmetro ResourceUri e o parâmetro Filter forem especificados, o parâmetro Filter será ignorado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResultClassName

Especifica o nome da classe das instâncias associadas. Uma instância CIM pode ser associada a uma ou mais instâncias CIM. Todas as instâncias CIM associadas serão retornadas se você não especificar o nome da classe de resultado.

Por padrão, o valor desse parâmetro é null, o que significa que todas as instâncias CIM associadas serão retornadas.

Você pode filtrar os resultados da associação para corresponder a um nome de classe específico. A filtragem acontece no servidor. Se esse parâmetro não for especificado, Get-CIMAssociatedInstance retornará todas as associações existentes. Por exemplo, se a classe A estiver associada às classes B, C e D, esse parâmetro pode ser usado para restringir a saída a um tipo específico (B, C ou D).

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

Object

Ligações Relacionadas

• Get-CimClass
• Get-CimInstance