Get-CimClass

  • Referência
Módulo:
CimCmdlets

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

Syntax

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

Este 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 disk 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 traduzir valores numéricos para valores legíveis por humanos.

Esse parâmetro foi adicionado no PowerShell 7.3.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 cmdlet. O padrão é a sessão atual no computador local.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClassName

Especifica o nome da classe CIM para a qual executar a operação. 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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-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ê 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 proporcionará um melhor desempenho.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MethodName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Namespace

Especifica o namespace para a operação 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.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 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.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PropertyName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-QualifierName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

CimClass

Este cmdlet retorna um objeto de classe CIM.

Notas

O PowerShell inclui os seguintes aliases para Get-CimClass:

  • Windows:
    • gcls

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