Get-WmiObject

Sintaxe

Get-WmiObject
   [-Class] <String>
   [[-Property] <String[]>]
   [-Filter <String>]
   [-Amended]
   [-DirectRead]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [[-Class] <String>]
   [-Recurse]
   [-Amended]
   [-List]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-DirectRead]
   -Query <String>
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Description

A partir do PowerShell 3.0, esse cmdlet foi substituído por Get-CimInstance.

O cmdlet Get-WmiObject obtém instâncias de classes WMI ou informações sobre as classes WMI disponíveis. Para especificar um computador remoto, use o parâmetro ComputerName. Se o parâmetro List for especificado, o cmdlet obterá informações sobre as classes WMI disponíveis em um namespace especificado. Se o parâmetro Query for especificado, o cmdlet executará uma instrução WQL (linguagem de consulta WMI).

O cmdlet Get-WmiObject não usa a comunicação remota do Windows PowerShell para executar operações remotas. Você pode usar o parâmetro ComputerName do cmdlet Get-WmiObject mesmo que o computador não atenda aos requisitos de comunicação remota do Windows PowerShell ou não esteja configurado para comunicação remota no Windows PowerShell.

A partir do Windows PowerShell 3.0, a propriedade __Server do objeto que Get-WmiObject retorna tem um alias PSComputerName. Isso facilita a inclusão do nome do computador de origem na saída e nos relatórios.

Exemplos

Exemplo 1: Obter processos no computador local

Este exemplo obtém os processos no computador local.

Get-WmiObject -Class Win32_Process

Exemplo 2: Obtém serviços em um computador remoto

Este exemplo obtém os serviços em um computador remoto. O parâmetro ComputerName especifica o endereço IP de um computador remoto. Por padrão, a conta de usuário atual deve ser um membro do grupo Administradores no computador remoto.

Get-WmiObject -Class Win32_Service -ComputerName 10.1.4.62

Exemplo 3: Obter classes WMI no namespace raiz ou padrão do computador local

Este exemplo obtém as classes WMI no namespace raiz ou padrão do computador local.

Get-WmiObject -Namespace "root/default" -List

Exemplo 4: Obter um serviço nomeado em vários computadores

Este exemplo obtém o serviço WinRM nos computadores especificados pelo valor do parâmetro ComputerName.

Get-WmiObject -Query "select * from win32_service where name='WinRM'" -ComputerName Server01, Server02 |
  Format-List -Property PSComputerName, Name, ExitCode, Name, ProcessID, StartMode, State, Status

PSComputerName : SERVER01
Name           : WinRM
ExitCode       : 0
Name           : WinRM
ProcessID      : 844
StartMode      : Auto
State          : Running
Status         : OK

PSComputerName : SERVER02
Name           : WinRM
ExitCode       : 0
Name           : WinRM
ProcessID      : 932
StartMode      : Auto
State          : Running
Status         : OK

Um operador de pipeline (|) envia a saída para o cmdlet Format-List, que adiciona a propriedade PSComputerName à saída padrão. PSComputerName é um alias da propriedade __Server dos objetos que Get-WmiObject retorna. Esse alias foi introduzido no PowerShell 3.0.

Exemplo 5: Parar um serviço em um computador remoto

Este exemplo interrompe o serviço WinRM em um computador remoto. Get-WmiObject obtém a instância do objeto de serviço WinRM no Server01. Em seguida, ele invoca o método StopService da classe WMI Win32_Service nesse objeto.

(Get-WmiObject -Class Win32_Service -Filter "name='WinRM'" -ComputerName Server01).StopService()

Isso é equivalente ao uso do cmdlet Stop-Service.

Exemplo 6: Obter o BIOS no computador local

Este exemplo obtém as informações de BIOS do computador local. O parâmetro propriedade do cmdlet é usado para exibir todas as propriedades do objeto retornado em uma lista. Por padrão, somente o subconjunto de propriedades definido no arquivo de configuração Types.ps1xml é exibido.

Get-WmiObject -Class Win32_Bios | Format-List -Property *

Status                : OK
Name                  : Phoenix ROM BIOS PLUS Version 1.10 A05
Caption               : Phoenix ROM BIOS PLUS Version 1.10 A05
SMBIOSPresent         : True
__GENUS               : 2
__CLASS               : Win32_BIOS
__SUPERCLASS          : CIM_BIOSElement
__DYNASTY             : CIM_ManagedSystemElement
__RELPATH             : Win32_BIOS.Name="Phoenix ROM BIOS PLUS Version 1.10
__PROPERTY_COUNT      : 27
__DERIVATION          : {CIM_BIOSElement, CIM_SoftwareElement, CIM_LogicalElement,
__SERVER              : Server01
__NAMESPACE           : root\cimv2
__PATH                : \\SERVER01\root\cimv2:Win32_BIOS.Name="Phoenix ROM BIOS
BiosCharacteristics   : {7, 9, 10, 11...}
BIOSVersion           : {DELL   - 15, Phoenix ROM BIOS PLUS Version 1.10 A05}
BuildNumber           :
CodeSet               :
CurrentLanguage       : en|US|iso8859-1
Description           : Phoenix ROM BIOS PLUS Version 1.10 A05
IdentificationCode    :
InstallableLanguages  : 1
InstallDate           :
LanguageEdition       :
ListOfLanguages       : {en|US|iso8859-1}
Manufacturer          : Dell Inc.
OtherTargetOS         :
PrimaryBIOS           : True
ReleaseDate           : 20101103000000.000000+000
SerialNumber          : 8VDM9P1
SMBIOSBIOSVersion     : A05
SMBIOSMajorVersion    : 2
SMBIOSMinorVersion    : 6
SoftwareElementID     : Phoenix ROM BIOS PLUS Version 1.10 A05
SoftwareElementState  : 3
TargetOperatingSystem : 0
Version               : DELL   - 15
Scope                 : System.Management.ManagementScope
Path                  : \\SERVER01\root\cimv2:Win32_BIOS.Name="Phoenix ROM BIOS
Options               : System.Management.ObjectGetOptions
ClassPath             : \\JUNE-PC\root\cimv2:Win32_BIOS
Properties            : {BiosCharacteristics, BIOSVersion, BuildNumber, Caption...}
SystemProperties      : {__GENUS, __CLASS, __SUPERCLASS, __DYNASTY...}
Qualifiers            : {dynamic, Locale, provider, UUID}
Site                  :
Container             :

Exemplo 7: Obter os serviços em um computador remoto

Este exemplo usa o parâmetro de Credencial do cmdlet Get-WmiObject para obter os serviços em um computador remoto. O valor do parâmetro credencial é um nome de conta de usuário. O usuário é solicitado a fornecer uma senha.

Get-WmiObject Win32_Service -Credential FABRIKAM\administrator -ComputerName Fabrikam

Parâmetros

-Amended

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Credential

-DirectRead

-EnableAllPrivileges

-Filter

-Impersonation

-List

-Locale

-Namespace

-Property

-Query

-Recurse

-ThrottleLimit

Entradas

None

Não é possível redirecionar a entrada para Get-WmiObject.

Saídas

PSObject or System.Management.Automation.RemotingJob

Quando você usa o parâmetro AsJob, o cmdlet retorna um objeto de trabalho. Caso contrário, o objeto que retorna depende do valor do parâmetro de Classe .

Observações

Para acessar informações do WMI em um computador remoto, o cmdlet deve ser executado em uma conta que seja membro do grupo de administradores locais no computador remoto. Ou o controle de acesso padrão no namespace WMI do repositório remoto pode ser alterado para conceder direitos de acesso a outras contas.

Apenas algumas das propriedades de cada classe WMI são exibidas por padrão. O conjunto de propriedades que é exibido para cada classe WMI é especificado no arquivo de configuração Types.ps1xml. Para obter todas as propriedades de um objeto WMI, use os cmdlets Get-Member ou Format-List.

Links Relacionados

• Invoke-WmiMethod
• Remove-WmiObject
• Set-WmiInstance
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• Remove-WSManInstance