Get-CimClass
Obtém uma lista de classes CIM em um namespace específico.
Sintaxe
ComputerSet (Default)
Get-CimClass
[[-ClassName] <string>]
[[-Namespace] <string>]
[-Amended]
[-OperationTimeoutSec <uint>]
[-ComputerName <string[]>]
[-MethodName <string>]
[-PropertyName <string>]
[-QualifierName <string>]
[<CommonParameters>]
SessionSet
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 cmdlet Get-CimClass 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 raiz/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 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 raiz/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 cmdlet New-CimSession e, em seguida, obtém as classes usando o cmdlet Get-CimClass.
Parâmetros
-Amended
Indica que os objetos retornados da consulta CIM devem conter informações alteradas. Normalmente, informações alteradas são informações localizáveis, como descrições de objeto e propriedade 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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 cmdlet New-CimSession ou Get-CimSession. O padrão é a sessão atual no computador local.
Propriedades do parâmetro
| Tipo: | |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SessionSet
| 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 a qual executar a operação. 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: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| 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ê 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 COM (Component Object Model).
Se várias operações estiverem sendo executadas no mesmo computador, o uso de uma sessão CIM oferecerá melhor 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
ComputerSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MethodName
Localiza as classes que têm um método que corresponde a esse nome. Você pode usar caracteres curinga com esse parâmetro.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Namespace
Especifica o namespace para a operação 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
(All)
| Cargo: | 1 |
| 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: | True |
| Valor dos argumentos restantes: | False |
-PropertyName
Localiza as classes que têm uma propriedade correspondente a esse nome. Você pode usar caracteres curinga com esse parâmetro.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-QualifierName
Filtra as classes por nome do qualificador de nível de classe. Você pode usar caracteres curinga com esse parâmetro.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| 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
None
Não é possível transferir 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
Este cmdlet está disponível apenas em plataformas Windows.