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 esse cmdlet. Este cmdlet retorna um ou mais objetos de instância do CIM que representam um instantâneo das instâncias do 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 forem especificados, esse cmdlet funcionará no 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, esse 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 forem especificados, 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 valor do parâmetro ComputerName.
Exemplos
Exemplo 1: Obter as instâncias CIM de uma classe especificada
Get-CimInstance -ClassName Win32_Process
Este comando recupera as instâncias CIM de uma classe chamada Win32_Process.
Exemplo 2: Obter uma lista de namespaces de um servidor WMI
Este comando recupera uma lista de namespaces no namespace Root em um servidor WMI.
Exemplo 3: Obter instâncias de uma classe filtradas usando uma consulta
Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'p%'"
Este comando recupera todas as instâncias CIM que começam com a letra p de uma classe chamada Win32_Process usando a consulta especificada por um parâmetro Query .
Exemplo 4: Obter instâncias de uma classe filtradas usando um nome de classe e uma expressão de filtro
Get-CimInstance -ClassName Win32_Process -Filter "Name like 'p%'"
Este 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 do CIM com apenas as propriedades da chave preenchidas
Esse conjunto de comandos cria uma nova instância do CIM na memória para uma classe chamada Win32_Process com a propriedade de chave @{ "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 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 contendo apenas os atributos powershell e 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 chamados Server01 e Server02 usando o cmdlet New-CimSession e armazena as informações da sessão em uma variável chamada $s. O conteúdo da variável é então 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 crie ou obtenha a sessão CIM, como os cmdlets New-CimSession ou Get-CimSession. Para obter mais informações, consulte about_CimSession.
Propriedades dos parâmetros
Tipo:
CimSession[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ResourceUriSessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
QuerySessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
CimInstanceSessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ClassName
Especifica o nome da classe CIM para a qual recuperar as instâncias CIM. Você pode usar o preenchimento de guias para procurar a lista de classes, porque o PowerShell obtém uma lista de classes do servidor WMI local para fornecer uma lista de nomes de classe.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ClassNameComputerSet
Position:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-ComputerName
Especifica o computador no qual você deseja executar a operação CIM. Você pode especificar um nome de domínio totalmente qualificado (FQDN), 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 o 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 obter um melhor desempenho.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
China, Nome do servidor
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
CimInstanceComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QueryComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-Filter
Especifica uma cláusula where a ser usada como filtro. Especifique a cláusula no WQL ou na linguagem de consulta CQL .
Nota: Não inclua a palavra-chave where no valor do parâmetro.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
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 passar o objeto de instância CIM para obter o instantâneo mais recente 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 enumerate ou query. 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 dos parâmetros
Tipo:
CimInstance
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
CimInstance
Conjuntos de parâmetros
CimInstanceSessionSet
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
CimInstanceComputerSet
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-KeyOnly
Indica que somente objetos com propriedades de chave preenchidas 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 usado para outras operações, como os cmdlets Set-CimInstance ou Get-CimAssociatedInstance.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ResourceUriSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Namespace
Especifica o namespace da classe CIM.
O namespace padrão é root/cimv2. Você pode usar o preenchimento de guias para procurar a lista de namespaces, porque o PowerShell obtém uma lista de namespaces do servidor WMI local para fornecer a lista de namespaces.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QuerySessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QueryComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-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 inferior ao 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
Tipo:
UInt32
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
OT
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Property
Especifica um conjunto de propriedades de instância a serem recuperadas. Use este parâmetro quando precisar reduzir o tamanho do objeto retornado, seja na memória ou pela 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 dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
SelecionarPropriedades
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
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 WQL LIKE, você deverá escapar dos seguintes caracteres colocando-os entre colchetes []: porcentagem %, sublinhado _ou abertura de colchete [.
Não é possível 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 dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
QuerySessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QueryComputerSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-QueryDialect
Especifica a linguagem de consulta usada para o parâmetro Query. Os valores aceitáveis para este parâmetro são: WQL ou CQL. O valor padrão é WQL.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QuerySessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QueryComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-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:
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, receberá 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
Tipo:
Uri
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ResourceUriSessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QuerySessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
QueryComputerSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
CimInstanceSessionSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
CimInstanceComputerSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-Shallow
Indica que as instâncias de uma classe são retornadas sem incluir as instâncias de quaisquer classes filhas. Por padrão, o cmdlet retorna as instâncias de uma classe e suas classes filhas.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
ClassNameComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ResourceUriSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
QuerySessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ClassNameSessionSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
ResourceUriComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
QueryComputerSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
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
Este cmdlet aceita um objeto de entrada especificado com o parâmetro InputObject.
Saídas
CIM Instance
Este cmdlet retorna um ou mais objetos de instância do CIM que representam um instantâneo das instâncias do CIM no servidor CIM.