New-CMRequirementRuleBooleanValue

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

Syntaxe

New-CMRequirementRuleBooleanValue
   -Value <Boolean>
   [-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 booléenne. La condition globale définit les critères spécifiques, et cette règle d’exigence évalue l’état booléen de cette condition globale sur l’appareil.

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 des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Rechercher l’état cogéré

Cet exemple utilise d’abord l’applet de commande Get-CMGlobalCondition pour obtenir la condition globale d’appareil cogéré par défaut. Ensuite, il crée l’objet de règle d’exigence pour évaluer la condition globale comme $true. Enfin, il transmet cet objet de règle à l’applet de commande Set-CMScriptDeploymentType pour ajouter la condition requise.

$myGC = Get-CMGlobalCondition -Name "Co-managed device"
$myRule = New-CMRequirementRuleBooleanValue -GlobalCondition $myGC -Value $true

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

Vous pouvez également utiliser cet exemple avec la condition globale d’appareil principal par défaut, qui est la seule condition globale de type d’utilisateur par défaut.

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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

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

Pour afficher la liste des conditions globales booléennes disponibles sur le site, utilisez la commande PowerShell suivante :

Get-CMGlobalCondition | Where-Object DataType -eq "Boolean" | Select-Object LocalizedDisplayName

Type:IResultObject
Alias:GlobalCondition
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Value

Spécifiez l’état booléen dans lequel cette règle d’exigence doit évaluer la condition globale sur l’appareil. En d’autres termes, si vous souhaitez exiger que la condition globale soit true sur l’appareil, définissez ce paramètre sur $true.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object