Invoke-WmiMethod
Chama métodos WMI.
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>]
Invoke-WmiMethod
-InputObject <ManagementObject>
[-Name] <String>
[-ArgumentList <Object[]>]
[-AsJob]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-WmiMethod
-Path <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>]
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>]
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>]
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>]
O Invoke-WmiMethod
cmdlet chama os métodos de objetos WMI (Instrumentação de Gerenciamento do Windows).
Os novos cmdlets CIM (Common Information Model), introduzidos no Windows PowerShell 3.0, executam as mesmas tarefas que os cmdlets WMI. Os cmdlets CIM estão em conformidade com os padrões WS-Management (WSMan) e com o padrão CIM, que permite que os cmdlets usem as mesmas técnicas para gerenciar computadores Windows e aqueles que executam outros sistemas operacionais. Em vez de usar Invoke-WmiMethod
o , considere usar Invoke-CimMethod.
Este comando lista a ordem necessária dos objetos.
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)
Para invocar o WMI no PowerShell 3.0 difere dos métodos alternativos e requer que os valores do objeto sejam inseridos em uma ordem específica.
([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 :
Este comando inicia uma instância do Bloco de Notas chamando o Create
método da classe Win32_Process .
A propriedade ReturnValue é preenchida com um 0
, e a propriedade ProcessId é preenchida com um inteiro (o próximo número de ID do processo) se o comando for concluído.
$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
Este comando renomeia um arquivo. Ele usa o parâmetro Path para fazer referência a uma instância da classe CIM_DataFile . Em seguida, ele aplica o método Rename a essa instância específica.
A propriedade ReturnValue é preenchida com um 0
se o comando for concluído.
Um exemplo usando uma matriz de objetos $binSD
seguida por um $null
valor.
$acl = Get-Acl test.txt
$binSD = $acl.GetSecurityDescriptorBinaryForm()
$invokeWmiMethodSplat = @{
Class = 'Win32_SecurityDescriptorHelper'
Name = 'BinarySDToSDDL'
ArgumentList = $binSD, $null
}
Invoke-WmiMethod @invokeWmiMethodSplat
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 Invoke-CimCommand
cmdlet não tem essas limitações.
Para determinar a ordem na qual listar esses objetos, execute o GetMethodParameters()
método na classe WMI, conforme ilustrado no Exemplo 1, perto do final deste tópico.
Importante
Se o primeiro valor for uma matriz que contém mais de um elemento, um segundo valor de $null
será necessário. Caso contrário, o comando gerará um erro, como Unable to cast object of type 'System.Byte' to type 'System.Array'.
. Ver exemplo 4 supra.
Tipo: | Object[] |
Aliases: | Args |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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 Job
substantivo (os cmdlets Job). Para obter os resultados do trabalho, use o Receive-Job
cmdlet.
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.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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
: Inalterado0
: Padrão1
: Nenhum (Nenhuma autenticação executada.)2
: Connect (A autenticação é realizada somente quando o cliente estabelece um relacionamento com o aplicativo.)3
: Chamada (A autenticação é realizada somente no início de cada chamada, quando o aplicativo recebe a solicitação.)4
: Pacote (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.)
Tipo: | AuthenticationLevel |
Valores aceites: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica a classe WMI que contém um método estático para chamar.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica, como uma matriz de cadeia de caracteres, os computadores nos quais esse cmdlet executa o comando. A predefiniçã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.
Tipo: | String[] |
Aliases: | Cn |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Solicita a sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica uma conta de usuário que tem permissão para executar essa ação. A predefinição é o utilizador 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 Get-Credential
cmdlet. Quando introduz um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.
Tipo: | PSCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Indica que esse cmdlet habilita todos os privilégios do usuário atual antes que o comando faça a chamada WMI.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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 como3
: Representar.)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 os objetos permitam que outros objetos usem as credenciais do chamador.)
Tipo: | ImpersonationLevel |
Valores aceites: | Default, Anonymous, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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.
Tipo: | ManagementObject |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica a localidade preferida para objetos WMI. Especifique o valor do parâmetro Locale como uma matriz no MS_<LCID>
formato na ordem preferida.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica o nome do método a ser invocado. Este parâmetro é obrigatório e não pode ser nulo ou vazio.
Tipo: | String |
Position: | 1 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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.
Tipo: | String |
Aliases: | NS |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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 .
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
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.
Tipo: | Int32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
None
Este cmdlet não aceita nenhuma entrada.
None
Este cmdlet não gera nenhuma saída.
O Windows PowerShell inclui os seguintes aliases para Invoke-WmiMethod
:
iwmi
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: