Get-CimAssociatedInstance
Recupera as instâncias cim que estão conectadas a uma instância cim específica por uma associação.
Sintaxe
ComputerSet (Padrã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
Este cmdlet só está disponível na plataforma Windows.
O cmdlet Get-CimAssociatedInstance recupera as instâncias cim conectadas a uma instância cim específica, chamada instância de origem, por uma associação.
Em uma associação, cada instância cim tem uma função nomeada e a mesma instância cim pode participar de uma associação em funções diferentes.
Se o parâmetro InputObject não for especificado, o cmdlet funcionará de uma das seguintes maneiras:
- Se nem o parâmetro ComputerName nem o parâmetro CimSession for especificado, esse cmdlet funcionará na WMI (Instrumentação de Gerenciamento do Windows) local usando uma sessão COM (Component Object Model).
- Se o parâmetro ComputerName ou o parâmetro CimSession for especificado, este cmdlet funcionará no servidor CIM especificado pelo parâmetro ComputerName ou pelo parâmetro CimSession.
Exemplos
Exemplo 1: Obter todas as instâncias associadas de uma instância específica
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]
Esse conjunto de comandos recupera as instâncias da classe chamada Win32_LogicalDisk e armazena as informações em uma variável chamada $disk usando o cmdlet Get-CimInstance. A primeira instância de disco lógico na variável é então usada como o objeto de entrada do cmdlet Get-CimAssociatedInstance para obter todas as instâncias CIM associadas da instância cim especificada.
Exemplo 2: Obter todas as instâncias associadas de um tipo específico
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition
Esse conjunto de comandos recupera todas as instâncias da classe Win32_LogicalDisk e as armazena em uma variável chamada $disk. A primeira instância de disco lógico na variável é então usada como o objeto de entrada do cmdlet Get-CimAssociatedInstance para obter todas as instâncias associadas associadas por meio da classe de associação especificada Win32_DiskPartition.
Exemplo 3: Obter todas as instâncias associadas por meio do qualificador de uma classe específica
Esse conjunto de comandos recupera os serviços que dependem do serviço Winmgmt e os armazena em uma variável chamada $s.
Get-CimAssociatedInstance obtém as instâncias associadas da classe de associação 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 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 de qualquer tipo.
Por exemplo, se a classe A estiver associada à classe B por meio de duas associações, AB1 e AB2, esse parâmetro poderá ser usado para especificar o tipo de associação, AB1 ou AB2.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-CimSession
Executa o comando usando a sessão CIM especificada. Insira uma variável que contenha a sessão CIM ou um comando que cria ou obtém a sessão CIM, como New-CimSession ou Get-CimSession. Para obter mais informações, consulte about_CimSession.
Propriedades do parâmetro
| Tipo: | |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SessionSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ComputerName
Especifica o nome do computador no qual você deseja executar a operação CIM. Você pode especificar um FQDN (nome de domínio totalmente qualificado) 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 COM (Component Object Model).
Se várias operações estiverem sendo executadas no mesmo computador, conectar-se usando uma sessão CIM oferecerá melhor desempenho.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | China, Nome do Servidor |
Conjuntos de parâmetros
ComputerSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InputObject
Especifica a entrada para este cmdlet. Você pode usar esse parâmetro ou redirecionar a entrada para este cmdlet.
O parâmetro InputObject não enumera em coleções. Se uma coleção for passada, um erro é gerado. Ao trabalhar com coleções, redirecione a entrada para enumerar os valores.
Propriedades do parâmetro
| Tipo: | CimInstance |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | CimInstance |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-KeyOnly
Retorna objetos com apenas propriedades de chave preenchidas. Isso reduz a quantidade de dados transferidos pela rede.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Namespace
Especifica o namespace para a operação CIM. O namespace padrão é raiz/CIMV2.
Observação
Você pode usar o preenchimento de guia para navegar na lista de namespaces, pois o PowerShell obtém uma lista de namespaces do servidor WMI local para fornecer a lista de namespaces.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-OperationTimeoutSec
Especifica a quantidade de tempo que o cmdlet aguarda 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, pois a operação no servidor atinge o tempo limite antes que o cliente possa se reconectar.
Propriedades do parâmetro
| Tipo: | UInt32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | OT |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResourceUri
Especifica o identificador uniforme de recurso (URI) 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:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Por padrão, se você não especificar esse parâmetro, o URI de recurso padrão DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ será usado e o nome da classe será acrescentado 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 o 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, receberá um erro, pois o protocolo DCOM não dá suporte ao parâmetro ResourceUri.
Se tanto o parâmetro ResourceUri quanto o parâmetro Filter forem especificados, o parâmetro Filter será ignorado.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResultClassName
Especifica o nome da classe das instâncias associadas. Uma instância cim pode ser associada a uma ou mais instâncias de 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 é nulo e todas as instâncias cim associadas são retornadas.
Você pode filtrar os resultados da associação para corresponder a um nome de classe específico. A filtragem ocorre 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 poderá ser usado para restringir a saída a um tipo específico (B, C ou D).
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível transferir objetos para esse cmdlet.
Saídas
CimInstance
Esse cmdlet retorna um objeto de instância CIM.
Observações
O PowerShell inclui os seguintes aliases para Get-CimAssociatedInstance:
- Windows:
gcai
Este cmdlet está disponível apenas em plataformas Windows.
