New-CMRequirementRuleExpression

  • Referência
Módulo:
ConfigurationManager

Crie uma regra de requisito para avaliar uma condição global personalizada com uma expressão complexa.

Sintaxe

New-CMRequirementRuleExpression
   [-AddAsGroup]
   [-AddExpression <ExpressionBase[]>]
   [-AddRequirementRule <Rule[]>]
   [-ClauseOperator <ConnectOperator>]
   [-GroupOperator <ConnectOperator>]
   [-RootExpression <ExpressionBase>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para criar uma regra de requisito num tipo de implementação de aplicação que avalie uma condição global personalizada com uma expressão complexa. Quando cria uma condição global, o tipo condição tem de ser Expressão. Estas expressões permitem-lhe adicionar múltiplas cláusulas e agrupá-las com operadores lógicos.

Para criar uma condição global personalizada com uma expressão, utilize o cmdlet New-CMGlobalConditionExpression .

Depois de utilizar o cmdlet New-CMRequirementRuleExpression , utilize um dos cmdlets Add- ou Set- para tipos de implementação. Transmita este objeto de regra de requisito para os parâmetros AddRequirement ou RemoveRequirement .

Para obter mais informações, veja Requisitos do tipo de implementação e Criar condições globais.

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: Adicionar uma expressão básica

$rule1 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 2048 -RuleOperator GreaterEquals
$myRuleExpression = New-CMRequirementRuleExpression -AddRequirementRule $rule1
$myGC = New-CMGlobalConditionExpression -Name "GCExp" -DeviceType Windows -RootExpression $myRuleExpression

Exemplo 2: Adicionar uma expressão de condição global complexa

$ruleProc = Get-CMGlobalCondition -Name "Number of processors" | New-CMRequirementRuleCommonValue -Value1 2 -RuleOperator GreaterEquals
$ruleMem1 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 2048 -RuleOperator GreaterThan
$ruleMem2 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 4096 -RuleOperator LessEquals
$ruleCPUSpeed1 = Get-CMGlobalCondition -Name "CPU Speed" | New-CMRequirementRuleCommonValue -Value1 5120 -RuleOperator LessEquals
$ruleCPUSpeed2 = Get-CMGlobalCondition -Name "CPU Speed" | New-CMRequirementRuleCommonValue -Value1 1024 -RuleOperator GreaterThan
$expressionProc = New-CMRequirementRuleExpression -AddRequirementRule $ruleProc
$expressionMem = New-CMRequirementRuleExpression -AddRequirementRule $ruleMem1, $ruleMem2 -ClauseOperator And
$expressionCPU = New-CMRequirementRuleExpression -AddRequirementRule $ruleCPUSpeed1, $ruleCPUSpeed2 -ClauseOperator And
$myRuleExpression = New-CMRequirementRuleExpression -RootExpression $expressionProc -AddExpression $expressionMem,$expressionCPU -ClauseOperator And -AddAsGroup -GroupOperator Or
$myGC = New-CMGlobalConditionExpression -Name "GCExp" -DeviceType Windows -RootExpression $myRuleExpression

Parâmetros

-AddAsGroup

Adicione este parâmetro para adicionar as expressões como um grupo. Especifique mais do que uma expressão com o parâmetro AddExpression . Utilize o parâmetro GroupOperator para especificar o conector.

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

-AddExpression

Especifique um ou mais objetos de expressão a adicionar a uma nova expressão. Crie estes objetos com este mesmo cmdlet. Utilize o parâmetro RootExpression para especificar a primeira expressão.

Tipo:ExpressionBase[]
Aliases:AddExpressions
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddRequirementRule

Especifique uma matriz de objetos de requisitos para a expressão. Para criar um objeto de regra de requisito, utilize um dos seguintes cmdlets:

Tipo:Rule[]
Aliases:AddRequirementRules
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClauseOperator

Especifique o operador lógico a utilizar como conector entre múltiplas expressões.

Tipo:ConnectOperator
Valores aceitos:And, Or
Cargo:Named
Valor padrão:None
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

-GroupOperator

Especifique o operador lógico a utilizar como conector entre grupos. Utilize este parâmetro com o parâmetro AddAsGroup .

Tipo:ConnectOperator
Valores aceitos:And, Or
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RootExpression

Especifique a primeira expressão com este parâmetro. Crie um objeto de expressão com este mesmo cmdlet. Para adicionar mais do que uma expressão, utilize também o parâmetro AddExpression .

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

Entradas

None

Saídas

System.Object