Invoke-WmiMethod

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.

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 "Não é possível converter objeto do tipo 'System.Byte' para digitar 'System.Array'.".

Segue-se um exemplo usando uma matriz de objetos ($binSD) seguida por um valor nulo ($null):

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

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

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

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.

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: Conectar (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.)

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.

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

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.

Solicita confirmação antes de executar o cmdlet.

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 introduz um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

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

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: 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 outros objetos permitam que outros objetos usem as credenciais do chamador.)

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.

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

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

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.

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.

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.

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