Share via

New-CMRequirementRuleCommonValue

  • Référence
Module:
ConfigurationManager

Créez une règle d’exigence pour évaluer une condition globale basée sur une valeur sur un type de déploiement d’application.

Syntax

New-CMRequirementRuleCommonValue
   [-PropertyForAssembly <AssemblyProperty>]
   [-PropertyForFileFolder <FileFolderProperty>]
   -RuleOperator <RuleExpressionOperator>
   -Value1 <String[]>
   [-Value2 <String[]>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer une règle d’exigence sur un type de déploiement d’application qui évalue une condition globale avec un type de règle Valeur .

Après avoir utilisé cette applet de commande, utilisez l’une des applets de commande Add- ou Set- pour les types de déploiement. Transmettez cet objet de règle d’exigence aux paramètres AddRequirement ou RemoveRequirement .

Pour plus d’informations, consultez Configuration requise du type de déploiement et Créer des conditions globales.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Ajouter une règle d’exigence pour le nombre de processeurs

Cet exemple utilise d’abord l’applet de commande Get-CMGlobalCondition pour obtenir la condition globale nombre de processeurs par défaut. Ensuite, il crée l’objet de règle d’exigence pour évaluer que la condition globale sur l’appareil doit être supérieure ou égale à deux. Enfin, il transmet cet objet de règle à l’applet de commande Set-CMScriptDeploymentType pour ajouter la condition requise.

En d’autres termes, l’appareil doit avoir au moins deux processeurs pour que l’application soit installée.

$myGC = Get-CMGlobalCondition -Name "Number of processors"
$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -Value1 "2" -RuleOperator GreaterEquals

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-InputObject

Spécifiez un objet de condition globale à utiliser comme base pour cette règle d’exigence. Pour obtenir cet objet, utilisez l’applet de commande Get-CMGlobalCondition .

La condition globale doit prendre en charge le type de règlevaleur.

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

-PropertyForAssembly

Si la condition globale le prend en charge, spécifiez la propriété d’assembly à comparer avec la valeur attendue.

Type:AssemblyProperty
Accepted values:Culture, Version, PublicKeyToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PropertyForFileFolder

Si la condition globale le prend en charge, spécifiez une propriété de fichier ou de dossier à comparer avec la valeur attendue.

Par exemple :

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -PropertyForFileFolder DateCreated -Value1 "2018-08-07T05:32:45Z" -RuleOperator GreaterEquals

Type:FileFolderProperty
Accepted values:Size, Version, DateCreated, DateModified, Company, ProductName, SHA1Hash, Permissions, Attributes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

Spécifiez l’opérateur pour comparer le paramètre de l’appareil à la valeur attendue.

Type:RuleExpressionOperator
Accepted values:And, Or, Other, IsEquals, NotEquals, GreaterThan, LessThan, Between, NotBetween, GreaterEquals, LessEquals, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains, AllOf, OneOf, NoneOf, SetEquals, SubsetOf, ExcludesAll
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value1

Spécifiez une chaîne ou un tableau de valeurs attendues à comparer.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value2

Si vous utilisez un RuleOperator comme Between, utilisez ce paramètre pour spécifier la valeur supérieure.

Par exemple :

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $GC -PropertyForFileFolder Size -Value1 200 -Value2 300 -RuleOperator Between

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object