Invoke-WmiMethod

Sintaxe

class (Default)

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 de objetos WMI

PS C:\> ([wmiclass]'Win32_Volume').GetMethodParameters('Format')
__GENUS           : 2
__CLASS           : __PARAMETERS
__SUPERCLASS      :
__DYNASTY         : __PARAMETERS
__RELPATH         :
__PROPERTY_COUNT  : 6
__DERIVATION      : {}
__SERVER          :
__NAMESPACE       :
__PATH            :
ClusterSize       : 0
EnableCompression : False
FileSystem        : NTFS
Label             :
QuickFormat       : False
Version           : 0
PSComputerName    :

Exemplo 2: iniciar uma instância de um aplicativo

PS C:\> ([Wmiclass]'Win32_Process').GetMethodParameters('Create')
__GENUS                   : 2
__CLASS                   : __PARAMETERS
__SUPERCLASS              :
__DYNASTY                 : __PARAMETERS
__RELPATH                 :
__PROPERTY_COUNT          : 3
__DERIVATION              : {}
__SERVER                  :
__NAMESPACE               :
__PATH                    :
CommandLine               :
CurrentDirectory          :
ProcessStartupInformation :
PSComputerName            : PS C:\> Invoke-WmiMethod -Path win32_process -Name create -ArgumentList 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

PS C:\> Invoke-WmiMethod -Path "CIM_DataFile.Name='C:\scripts\test.txt'" -Name Rename -ArgumentList "C:\scripts\test_bu.txt"
__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ReturnValue      : 0

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, próximo ao final deste tópico.

Importante: se o primeiro valor for uma matriz que contenha mais de um elemento, um segundo valor de $null será necessário. Caso contrário, o comando gerará um erro, como "Não é possível converter objeto do tipo 'System.Byte' para digitar 'System.Array'.".

Um exemplo usando uma matriz de objetos ($binSD) seguido de um valor nulo ($null) segue:

PS C:\>$acl = get-acl test.txt

PS C:\>$binSD = $acl. GetSecurityDescriptorBinaryForm()

PS C:\>invoke-wmimethod -class Win32_SecurityDescriptorHelper -Name -argumentlist $binSD BinarySDToSDDL, $null

Propriedades do parâmetro

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 exibe o prompt de comando. Você pode continuar a trabalhar na sessão enquanto o trabalho é concluído. Se Invoke-WmiMethod for usado em um computador remoto, o trabalho será criado no computador local e os resultados de computadores remotos serão automaticamente retornados para o computador local. Para gerenciar o trabalho, use os cmdlets que contêm o substantivo Job (os cmdlets de trabalho). 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 do parâmetro

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 em execução.)

2: Conectar (a autenticação é executada somente quando o cliente estabelece uma relação com o aplicativo.)

3: Chamada (a autenticação é executada somente no início de cada chamada quando o aplicativo recebe a solicitação.)

4: Pacote (a autenticação é executada 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 do parâmetro

Conjuntos de parâmetros

-Authority

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Class

Especifica a classe WMI que contém um método estático a ser chamado.

Propriedades do parâmetro

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 se o computador não estiver configurado para executar comandos remotos.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

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\User01 ou User@Contoso.com. Ou insira um objeto PSCredential, como um objeto retornado pelo cmdlet Get-Credential. Quando você digitar um nome de usuário, será solicitado que você solicite uma senha.

Propriedades do parâmetro

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 do parâmetro

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: Padrão (lê o registro local para o nível de representação padrão, que geralmente é definido como "3: Representação".)

1: Anônimo (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 do parâmetro

Conjuntos de parâmetros

-InputObject

Especifica um objeto ManagementObject 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 do parâmetro

Conjuntos de parâmetros

-Locale

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Namespace

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

Propriedades do parâmetro

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 do parâmetro

Conjuntos de parâmetros

-ThrottleLimit

Especifica um valor de limitação para o número de operações WMI que podem ser executadas simultaneamente. Esse parâmetro é usado junto com o parâmetro asJob . O limite de limitação se aplica somente ao comando atual, não à sessão ou ao computador.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

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

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

None

Links Relacionados

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