Compartilhar via

Get-CimClass

  • Referência
Módulo:
CimCmdlets

Obtém uma lista de classes CIM em um namespace específico.

Sintaxe

Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-ComputerName <string[]>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]
Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   -CimSession <CimSession[]>
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O Get-CimClass cmdlet recupera uma lista de classes CIM em um namespace específico. Se não houver nenhum nome de classe fornecido, o cmdlet retornará todas as classes no namespace. Ao contrário de uma instância CIM, as classes CIM não contêm a sessão CIM ou o nome do computador do qual são recuperadas.

Exemplos

Exemplo 1: Obter todas as definições de classe

Este exemplo obtém todas as definições de classe no namespace root/cimv2.

Get-CimClass

Exemplo 2: Obter as classes com um nome específico

Este exemplo obtém as classes que contêm a palavra disco em seus nomes.

Get-CimClass -ClassName *disk*

Exemplo 3: Obter as classes com um nome de método específico

Este exemplo obtém as classes que começam com o nome Win32 e têm um nome de método que começa com Term.

Get-CimClass -ClassName Win32* -MethodName Term*

Exemplo 4: Obter as classes com um nome de propriedade específico

Este exemplo obtém as classes que começam com o nome Win32 e têm uma propriedade chamada Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Exemplo 5: Obter as classes com um nome de qualificador específico

Este exemplo obtém as classes que começam com o nome Win32, contêm a palavra Disk em seus nomes e têm o qualificador especificado Association.

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

Exemplo 6: Obter as definições de classe de um namespace específico

Este exemplo obtém as definições de classe que contêm a palavra Net em seus nomes do namespace especificado root/standardCimv2.

Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*

Exemplo 7: Obter as definições de classe de um servidor remoto

Este exemplo obtém as definições de classe que contêm a palavra disco em seus nomes dos servidores remotos especificados Server01 e Server02.

Get-CimClass -ClassName *disk* -ComputerName Server01, Server02

Exemplo 8: Obter as classes usando uma sessão CIM

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *disk* -CimSession $s

Esse conjunto de comandos cria uma sessão com vários computadores e a armazena em uma variável $s usando o New-CimSession cmdlet e, em seguida, obtém as classes usando o Get-CimClass cmdlet.

Parâmetros

-Amended

Indica que os objetos retornados da consulta CIM devem conter informações alteradas. Normalmente, as informações alteradas são informações localizáveis, como descrições de objetos e propriedades anexadas ao objeto CIM. Isso é útil para converter valores numéricos em valores legíveis.

Esse parâmetro foi adicionado no PowerShell 7.3.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CimSession

Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um New-CimSession cmdlet ou Get-CimSession . O padrão é a sessão atual do computador local.

Tipo:CimSession[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ClassName

Especifica o nome da classe CIM para a qual executar a operação. Você pode usar o preenchimento de tabulação para procurar a lista de classes, pois o PowerShell obtém uma lista de classes do servidor WMI local para fornecer uma lista de nomes de classe.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-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ê 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, o uso de uma sessão CIM fornecerá melhor desempenho.

Tipo:String[]
Aliases:CN, ServerName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MethodName

Localiza as classes que têm um método correspondente a esse nome. Você pode usar caracteres curinga com esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Namespace

Especifica o namespace para a operação CIM. O namespace padrão é root/cimv2. Você pode usar o preenchimento de tabulação para procurar a lista de namespaces, pois o PowerShell obtém uma lista de namespaces do servidor WMI local para fornecer a lista de namespaces.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 robusta 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.

Tipo:UInt32
Aliases:OT
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PropertyName

Localiza as classes que têm uma propriedade correspondente a esse nome. Você pode usar caracteres curinga com esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-QualifierName

Filtra as classes por nome do qualificador de nível de classe. Você pode usar caracteres curinga com esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

CimClass

Esse cmdlet retorna um objeto de classe CIM.

Observações

O PowerShell inclui os seguintes aliases para Get-CimClass:

  • Windows:
    • gcls

Esse cmdlet só está disponível em plataformas Windows.