O cmdlet Get-CimInstance obtém as instâncias CIM de uma classe de um servidor CIM. Você pode especificar o nome da classe ou uma consulta para este cmdlet. Esse cmdlet retorna um ou mais objetos de instância CIM que representam um instantâneo das instâncias CIM presentes no servidor CIM.
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.
Se o parâmetro InputObject 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 usará a sessão CIM ou o nome do computador do objeto de entrada.
Se o parâmetro ComputerName ou o parâmetro CimSession for especificado, esse cmdlet usará o valor do parâmetro CimSession ou o valor do parâmetro ComputerName.
Exemplos
Exemplo 1: obter as instâncias CIM de uma classe especificada
Get-CimInstance -ClassName Win32_Process
Esse comando recupera as instâncias CIM de uma classe chamada Win32_Process.
Exemplo 2: obter uma lista de namespaces de um servidor WMI
Esse comando recupera uma lista de namespaces no namespace Raiz em um servidor WMI.
Exemplo 3: Obter instâncias de uma classe filtrada usando uma consulta
Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'p%'"
Esse comando recupera todas as instâncias de CIM que começam com a letra p de uma classe chamada Win32_Process usando a consulta especificada por um parâmetro de consulta .
Exemplo 4: Obter instâncias de uma classe filtrada usando um nome de classe e uma expressão de filtro
Get-CimInstance -ClassName Win32_Process -Filter "Name like 'p%'"
Esse comando recupera todas as instâncias cim que começam com a letra "p" de uma classe chamada Win32_Process usando o parâmetro Filter.
Exemplo 5: Obter as instâncias de CIM com apenas propriedades-chave preenchidas
Esse conjunto de comandos cria uma nova instância CIM na memória para uma classe chamada Win32_Process com a propriedade key @{ "Handle"=0 } e a armazena em uma variável chamada $x. A variável é passada como uma instância CIM para o cmdlet Get-CimInstance para obter uma instância específica.
Exemplo 6: recuperar instâncias de CIM e reutilizá-las
Esse conjunto de comandos obtém as instâncias CIM de uma classe chamada Win32_Process e as armazena nas variáveis $x e $y. A variável $x é formatada em uma tabela que contém apenas o powershell e os atributos do powershell, a tabela definida como AutoSize.
Exemplo 7: Obter instâncias CIM do computador remoto
Esse conjunto de comandos cria uma sessão CIM nos computadores denominados Server01 e Server02 usando o cmdlet New-CimSession e armazena as informações de sessão em uma variável chamada $s. O conteúdo da variável é passado para Get-CimInstance usando o parâmetro CimSession, para obter as instâncias CIM da classe chamada Win32_ComputerSystem.
Parâmetros
-CimSession
Especifica a sessão CIM a ser usada para este cmdlet. Insira uma variável que contenha a sessão CIM ou um comando que cria ou obtém a sessão CIM, como os cmdlets New-CimSession ou Get-CimSession. Para obter mais informações, consulte about_CimSession.
Propriedades do parâmetro
Tipo:
CimSession[]
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
QuerySessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
CimInstanceSessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-ClassName
Especifica o nome da classe CIM para recuperar as instâncias CIM. Você pode usar o preenchimento da guia para navegar na lista de classes, pois o PowerShell obtém uma lista de classes do servidor WMI local para fornecer uma lista de nomes de classe.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClassNameComputerSet
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
-ComputerName
Especifica o computador no qual você deseja executar a operação CIM. Você pode especificar um FQDN (nome de domínio totalmente qualificado), um nome NetBIOS ou um endereço IP. Se você não especificar esse parâmetro, o cmdlet executará a operação no computador local usando COM (Component Object Model).
Se você especificar esse parâmetro, o cmdlet criará uma sessão temporária para o computador especificado usando o protocolo WsMan.
Se várias operações estiverem sendo executadas no mesmo computador, conecte-se usando uma sessão CIM para melhorar o 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
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
CimInstanceComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QueryComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
-Filter
Especifica uma cláusula "where" a ser usada como um filtro. Especifique a cláusula na linguagem de consulta WQL ou na CQL.
Observação: não inclua a palavra-chave where no valor do parâmetro.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
-InputObject
Especifica um objeto de instância CIM a ser usado como entrada.
Se você já estiver trabalhando com um objeto de instância CIM, poderá usar esse parâmetro para passá-lo e obter a versão mais atual do servidor CIM. Quando você passa um objeto de instância CIM como uma entrada, Get-CimInstance retorna o objeto do servidor usando uma operação get CIM, em vez de uma operação de enumeração ou consulta. Usar uma operação get CIM é mais eficiente do que recuperar todas as instâncias e, em seguida, filtrá-las.
Se a classe CIM não implementar a operação get, especificar o parâmetro InputObject retornará um erro.
Propriedades do parâmetro
Tipo:
CimInstance
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Aliases:
CimInstance
Conjuntos de parâmetros
CimInstanceSessionSet
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
CimInstanceComputerSet
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-KeyOnly
Indica que somente objetos com propriedades de chave populadas são retornados. Especificar o parâmetro KeyOnly reduz a quantidade de dados transferidos pela rede.
Use o parâmetro KeyOnly para retornar apenas uma pequena parte do objeto, que pode ser usada para outras operações, como os cmdlets Set-CimInstance ou Get-CimAssociatedInstance.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ResourceUriComputerSet
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 da classe CIM.
O namespace padrão é raiz/cimv2. 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
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QuerySessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QueryComputerSet
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:
False
Valor dos argumentos restantes:
False
-Property
Especifica um conjunto de propriedades de instância a serem recuperadas. Use esse parâmetro quando precisar reduzir o tamanho do objeto retornado, na memória ou na rede.
O objeto retornado sempre tem propriedades de chave preenchidas, independentemente do conjunto de propriedades listadas pelo parâmetro Property. Outras propriedades da classe estão presentes, mas não são preenchidas.
Propriedades do parâmetro
Tipo:
String[]
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Aliases:
SelectProperties
Conjuntos de parâmetros
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
-Query
Especifica uma consulta a ser executada no servidor CIM. Se o valor especificado contiver aspas duplas ", aspas simples 'ou uma barra invertida \, você deverá escapar desses caracteres prefixando-os com o caractere de barra invertida. Se o valor especificado usar o operador LIKE do WQL, você deverá escapar dos seguintes caracteres colocando-os entre colchetes []: porcentagem %, sublinhado _ ou abrir colchete [.
Você não pode usar uma consulta de metadados para recuperar uma lista de classes ou uma consulta de evento.
Para recuperar uma lista de classes, use o cmdlet Get-CimClass.
Para recuperar uma consulta de evento, use o cmdlet Register-CimIndicationEvent.
Você pode especificar o dialeto de consulta usando o parâmetro QueryDialect.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
QuerySessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QueryComputerSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
-QueryDialect
Especifica a linguagem de consulta usada para o parâmetro de consulta. Os valores aceitáveis para esse parâmetro são: WQL ou CQL. O valor padrão é WQL.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QuerySessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QueryComputerSet
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:
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 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
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
ResourceUriComputerSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QuerySessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
QueryComputerSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
CimInstanceSessionSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
CimInstanceComputerSet
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
True
Valor dos argumentos restantes:
False
-Shallow
Indica que as instâncias de uma classe são retornadas sem incluir as instâncias de quaisquer classes filhos. Por padrão, o cmdlet retorna as instâncias de uma classe e suas subclasses.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClassNameComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ResourceUriSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
QuerySessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClassNameSessionSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ResourceUriComputerSet
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
QueryComputerSet
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
CIM Instance
Esse cmdlet aceita um objeto de entrada especificado com o parâmetro InputObject.
Saídas
CIM Instance
Esse cmdlet retorna um ou mais objetos de instância CIM que representam um instantâneo das instâncias CIM no servidor CIM.