Get-CimClass
Obtém uma lista de classes CIM em um namespace específico.
Sintaxe
ComputerSet (Predefinição)
Get-CimClass
[[-ClassName] <String>]
[[-Namespace] <String>]
[-OperationTimeoutSec <UInt32>]
[-ComputerName <String[]>]
[-MethodName <String>]
[-PropertyName <String>]
[-QualifierName <String>]
[<CommonParameters>]
SessionSet
Get-CimClass
[[-ClassName] <String>]
[[-Namespace] <String>]
-CimSession <CimSession[]>
[-OperationTimeoutSec <UInt32>]
[-MethodName <String>]
[-PropertyName <String>]
[-QualifierName <String>]
[<CommonParameters>]
Description
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
PS C:\>Get-CimClass
Este comando obtém todas as definições de classe sob o namespace root/cimv2.
Exemplo 2: Obter as classes com um nome específico
PS C:\>Get-CimClass -ClassName *disk*
Este comando obtém as classes que contêm a palavra disco em seus nomes.
Exemplo 3: Obter as classes com um nome de método específico
PS C:\>Get-CimClass -ClassName Win32* -MethodName Term*
Este comando obtém as classes que começam com o nome Win32 e têm um nome de método que começa com Term.
Exemplo 4: Obter as classes com um nome de propriedade específico
PS C:\>Get-CimClass -ClassName Win32* -PropertyName Handle
Este comando obtém as classes que começam com o nome Win32 e têm uma propriedade chamada Handle.
Exemplo 5: Obter as classes com um nome de qualificador específico
PS C:\>Get-CimClass -ClassName Win32*Disk* -QualifierName Association
Este comando 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.
Exemplo 6: Obter as definições de classe de um namespace específico
PS C:\>Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*
Este comando obtém as definições de classe que contêm a palavra Net em seus nomes do namespace especificado root/standardCimv2.
Exemplo 7: Obter as definições de classe de um servidor remoto
PS C:\>Get-CimClass -ClassName *disk* -ComputerName Server01, Server02
Este comando obtém as definições de classe que contêm a palavra disco em seus nomes dos servidores remotos especificados Server01 e Server02.
Exemplo 8: Obter as classes usando uma sessão CIM
PS C:\>$s = New-CimSession -ComputerName Server01, Server02
PS C:\>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
-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 dos parâmetros
| Tipo: | CimSession[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SessionSet
| 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 executar a operação. Observação : você pode usar o preenchimento de guia para procurar a lista de classes, porque o Windows 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: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | False |
| 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ê 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.
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
ComputerSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-MethodName
Localiza as classes que têm um método correspondente a esse nome.
Você pode usar caracteres curinga com esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Namespace
Especifica o namespace para a operação CIM.
O namespace padrão é root/cimv2. Observação : você pode usar o preenchimento de guias para procurar a lista de namespaces, porque o Windows 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
(All)
| Position: | 2 |
| 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 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.
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: | True |
| Valor dos restantes argumentos: | False |
-PropertyName
Localiza as classes que têm uma propriedade correspondente a esse nome.
Você pode usar caracteres curinga com esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-QualifierName
Filtra as classes por nome do qualificador de nível de classe. Você pode usar caracteres curinga com esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| 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
None
Este cmdlet não aceita objetos de entrada.
Saídas
CimClass
Este cmdlet retorna um objeto de classe CIM.