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