Invoke-WmiMethod

Sintaxe

class (Predefinição)

Invoke-WmiMethod
    [-Class] <String>
    [-Name] <String>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

object

Invoke-WmiMethod
    [-Name] <String>
    -InputObject <ManagementObject>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

path

Invoke-WmiMethod
    [-Name] <String>
    -Path <String>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WQLQuery

Invoke-WmiMethod
    [-Name] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

query

Invoke-WmiMethod
    [-Name] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

list

Invoke-WmiMethod
    [-Name] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Listar a ordem necessária dos parâmetros do método WMI

Get-WmiObject Win32_Volume |
    Get-Member -MemberType Method -Name Format |
    Select-Object -ExpandProperty Definition

System.Management.ManagementBaseObject Format(System.String FileSystem, System.Boolean QuickFormat,
 System.UInt32 ClusterSize, System.String Label, System.Boolean EnableCompression,
 System.UInt32 Version)

Exemplo 2: Iniciar uma instância de um aplicativo

([wmiclass]'Win32_Process').Create.OverloadDefinitions

System.Management.ManagementBaseObject Create(System.String CommandLine, System.String CurrentDirectory,
 System.Management.ManagementObject#Win32_ProcessStartup ProcessStartupInformation)

Invoke-WmiMethod -Path Win32_Process -Name Create -ArgumentList C:\Windows\system32\notepad.exe

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 2
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ProcessId        : 11312
ReturnValue      : 0
PSComputerName   :

Exemplo 3: Renomear um arquivo

$invokeWmiMethodSplat = @{
    Path = "CIM_DataFile.Name='C:\scripts\test.txt'"
    Name = 'Rename'
    ArgumentList = 'C:\scripts\test_bu.txt'
}
Invoke-WmiMethod @invokeWmiMethodSplat

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ReturnValue      : 0

Exemplo 4: Passando uma matriz de valores usando '-ArgumentList'

$acl = Get-Acl test.txt
$binSD = $acl.GetSecurityDescriptorBinaryForm()
$invokeWmiMethodSplat = @{
    Class = 'Win32_SecurityDescriptorHelper'
    Name = 'BinarySDToSDDL'
    ArgumentList = $binSD, $null
}
Invoke-WmiMethod @invokeWmiMethodSplat

Parâmetros

-ArgumentList

Especifica os parâmetros a serem passados para o método chamado. O valor desse parâmetro deve ser uma matriz de objetos e eles devem aparecer na ordem exigida pelo método chamado. O cmdlet Invoke-CimCommand não tem essas limitações.

Para determinar a ordem na qual listar esses objetos, execute o método GetMethodParameters() na classe WMI, conforme ilustrado no Exemplo 1, perto do final deste tópico.

Propriedades dos parâmetros

Conjuntos de parâmetros

-AsJob

Indica que esse cmdlet executa o comando como um trabalho em segundo plano. Use esse parâmetro para executar comandos que levam muito tempo para serem concluídos.

Quando você usa o parâmetro AsJob, o comando retorna um objeto que representa o trabalho em segundo plano e, em seguida, exibe o prompt de comando. Você pode continuar a trabalhar na sessão enquanto o trabalho termina. Se Invoke-WmiMethod for usado em um computador remoto, o trabalho será criado no computador local e os resultados dos computadores remotos serão retornados automaticamente ao computador local. Para gerenciar o trabalho, use os cmdlets que contêm o substantivo Job (os cmdlets Job). Para obter os resultados do trabalho, use o cmdlet Receive-Job.

Para usar esse parâmetro com computadores remotos, os computadores locais e remotos devem ser configurados para comunicação remota. Além disso, você deve iniciar o Windows PowerShell usando a opção Executar como administrador no Windows Vista e versões posteriores do Windows. Para obter mais informações, consulte about_Remote_Requirements.

Para obter mais informações sobre trabalhos em segundo plano do Windows PowerShell, consulte about_Jobs e about_Remote_Jobs.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Authentication

Especifica o nível de autenticação a ser usado com a conexão WMI. Os valores aceitáveis para este parâmetro são:

• -1: Inalterado
• 0: Padrão
• 1: Nenhum (Nenhuma autenticação executada.)
• 2: Connect (A autenticação é realizada somente quando o cliente estabelece um relacionamento com o aplicativo.)
• 3: Call (A autenticação é realizada somente no início de cada chamada, quando o aplicativo recebe a solicitação.)
• 4: Packet (A autenticação é realizada em todos os dados recebidos do cliente.)
• 5: PacketIntegrity (Todos os dados transferidos entre o cliente e o aplicativo são autenticados e verificados.)
• 6: PacketPrivacy (As propriedades dos outros níveis de autenticação são usadas e todos os dados são criptografados.)

Propriedades dos parâmetros

Conjuntos de parâmetros

-Authority

Especifica a autoridade a ser usada para autenticar a conexão WMI. Você pode especificar o Windows NT LAN Manager (NTLM) padrão ou autenticação Kerberos. Para usar NTLM, defina a configuração de autoridade como ntlmdomain:<DomainName>, onde <DomainName> identifica um nome de domínio NTLM válido. Para usar Kerberos, especifique kerberos:<DomainName>\<ServerName>. Não é possível incluir a configuração de autoridade quando você se conecta ao computador local.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Class

Especifica a classe WMI que contém um método estático para chamar.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ComputerName

Especifica, como uma matriz de cadeia de caracteres, os computadores nos quais esse cmdlet executa o comando. O padrão é o computador local.

Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado de um ou mais computadores. Para especificar o computador local, digite o nome do computador, um ponto (.) ou localhost.

Esse parâmetro não depende da comunicação remota do Windows PowerShell. Você pode usar o parâmetro ComputerName mesmo que o computador não esteja configurado para executar comandos remotos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

Especifica uma conta de usuário que tem permissão para executar essa ação. O padrão é o usuário atual. Digite um nome de usuário, como User01, Domain01\User01ou User@Contoso.com. Ou insira um objeto PSCredential , como um objeto retornado pelo cmdlet . Quando introduz um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

Propriedades dos parâmetros

Conjuntos de parâmetros

-EnableAllPrivileges

Indica que esse cmdlet habilita todos os privilégios do usuário atual antes que o comando faça a chamada WMI.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Impersonation

Especifica o nível de representação a ser usado. Os valores aceitáveis para este parâmetro são:

• 0: Default (Lê o registro local para o nível de representação padrão, que geralmente é definido como 3: Impersonate.)
• 1: Anonymous (Oculta as credenciais do chamador.)
• 2: Identificar (Permite que os objetos consultem as credenciais do chamador.)
• 3: Representar (Permite que os objetos usem as credenciais do chamador.)
• 4: Delegar (Permite que objetos permitam que outros objetos usem as credenciais do chamador.)

Propriedades dos parâmetros

Conjuntos de parâmetros

-InputObject

Especifica um ManagementObject objeto a ser usado como entrada. Quando esse parâmetro é usado, todos os outros parâmetros, exceto os parâmetros Flag e Argument são ignorados.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Locale

Especifica a localidade preferida para objetos WMI. Especifique o valor do parâmetro Locale como uma matriz no formato MS_<LCID> na ordem preferida.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Especifica o nome do método a ser invocado. Este parâmetro é obrigatório e não pode ser nulo ou vazio.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Namespace

Quando usado com o parâmetro Class, esse parâmetro especifica o namespace do repositório WMI onde a classe ou objeto WMI referenciado está localizado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Path

Especifica o caminho do objeto WMI de uma classe WMI ou especifica o caminho do objeto WMI de uma instância de uma classe WMI. A classe ou a instância especificada deve conter o método especificado no parâmetro Name.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ThrottleLimit

Especifica um valor de aceleração para o número de operações WMI que podem ser executadas simultaneamente. Este parâmetro é usado em conjunto com o parâmetro AsJob. O limite de aceleração aplica-se apenas ao comando atual, não à sessão ou ao computador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

None

Notas

Ligações Relacionadas

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