Share via

Invoke-CMWmiMethod

  • Referência
Módulo:
ConfigurationManager

Chama um método WMI.

Syntax

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 Windows métodos de Instrumentação de Gerenciamento (WMI) fornecidos no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Chamar um método WMI usando o pipeline

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

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

O comando obtém o objeto do grupo de limite chamado Boundary1 e usa o operador de pipeline para passar o objeto para Invoke-CMWmiMethod. Invoke-CMWmiMethod chama o método WMI AddBoundary que adiciona os limites especificados por suas IDs ao limite do grupo Limite1.

Parâmetros

-ClassName

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

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica um objeto de gerenciamento ou um objeto Configuration Management.

Type:IResultObject
Aliases:Instance
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MethodName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Parameter

Especifica o nome da propriedade e o valor do método. O nome e o valor devem estar em um par de nomes/valores. O par nome/valor é passado na linha de comando como uma tabela de hash.

Type:Hashtable
Aliases:Parameters
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object