Compartilhar via

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>]
   [-OperationTimeoutSec <UInt32>]
   [-ComputerName <String[]>]
   [-MethodName <String>]
   [-PropertyName <String>]
   [-QualifierName <String>]
   [<CommonParameters>]
Get-CimClass
   [[-ClassName] <String>]
   [[-Namespace] <String>]
   [-OperationTimeoutSec <UInt32>]
   -CimSession <CimSession[]>
   [-MethodName <String>]
   [-PropertyName <String>]
   [-QualifierName <String>]
   [<CommonParameters>]

Description

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

-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.

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 a conclusão de tabulação 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 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 proporcionará 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 a conclusão de tabulação 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 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 de 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 esse cmdlet.

Saídas

CimClass

Esse cmdlet retorna um objeto de classe CIM.