Invoke-CMWmiMethod

Chama um método WMI.

Sintaxe

Invoke-CMWmiMethod
      [-ClassName] <String>
      -MethodName <String>
      [-Parameter <Hashtable>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMWmiMethod
      [-InputObject] <IResultObject>
      -MethodName <String>
      [-Parameter <Hashtable>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Invoke-CMWmiMethod chama métodos WMI (Windows Management Instrumentation) fornecidos no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: chamar um método WMI com o pipeline

PS XYZ:\> Get-CMBoundaryGroup -Name "Boundary1" | Invoke-CMWmiMethod -MethodName "AddBoundary" -Parameter @{BoundaryId = 16777217,16777218}

Este comando utiliza um método WMI para adicionar uma matriz de limites a um grupo de limites.

O comando obtém o objeto de grupo de limites denominado Boundary1 e utiliza o operador de pipeline para transmitir o objeto para Invoke-CMWmiMethod. Invoke-CMWmiMethod chama o método WMI AddBoundary, que adiciona os limites especificados pelos respetivos IDs ao grupo de limites Boundary1.

Parâmetros

-ClassName

Especifica o nome da classe WMI que contém o método estático que pretende chamar.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de gestão ou um objeto de Gestão de Configuração.

Tipo:IResultObject
Aliases:Instance
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MethodName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Parameter

Especifica o nome da propriedade e o valor do método . O nome e o valor têm de estar num par de nome/valor. O par nome/valor é transmitido na linha de comandos como uma tabela hash.

Tipo:Hashtable
Aliases:Parameters
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object