New-CMRequirementRuleOperatingSystemValue

  • Référence
Module:
ConfigurationManager

Créez une règle de configuration requise du système d’exploitation pour un type de déploiement d’application.

Syntaxe

New-CMRequirementRuleOperatingSystemValue
   [-Platform <IResultObject[]>]
   [-PlatformString <String[]>]
   -RuleOperator <RuleExpressionOperator>
   [-SelectFullPlatform <FullPlatformOption>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer une règle de configuration requise du système d’exploitation pour un type de déploiement d’application.

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 : Ajouter une règle d’exigence pour un système d’exploitation par plateforme

Cet exemple utilise d’abord l’applet de commande Get-CMGlobalCondition pour obtenir la condition globale du système d’exploitation par défaut pour les appareils Windows non mobiles. Il utilise ensuite l’applet de commande Get-CMConfigurationPlatform pour définir des variables pour deux plateformes pour Windows Server 2016 et Windows Server 2019. Ensuite, il crée l’objet de règle d’exigence pour inclure ces deux plateformes. Enfin, il transmet cet objet de règle à l’applet de commande Set-CMScriptDeploymentType pour ajouter la condition requise.

$myGC = Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1

$platformA = Get-CMConfigurationPlatform -Name "All Windows Server 2019 and higher (64-bit)" -Fast

$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)" -Fast

$myRule = $myGC | New-CMRequirementRuleOperatingSystemValue -RuleOperator OneOf -Platform $platformA, $platformB

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
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 à utiliser comme base pour cette règle d’exigence. Pour obtenir cet objet, utilisez l’applet de commande Get-CMGlobalCondition .

Dans la plupart des cas, vous allez utiliser la condition globale du système d’exploitation par défaut pour les appareils Windows non mobiles. Par exemple : Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1.

Remarque

Par défaut, Configuration Manager a deux conditions globales nommées Système d’exploitation. Vous pouvez les distinguer par type d’appareil à l’aide de la propriété PlatformType :

PlatformType Type d’appareil
1 Windows
2 Mobile
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

-Platform

Spécifiez un tableau d’un ou plusieurs objets de plateforme de système d’exploitation. Pour obtenir cet objet, utilisez l’applet de commande Get-CMConfigurationPlatform .

Type:IResultObject[]
Alias:Platforms
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PlatformString

Au lieu d’utiliser l’applet de commande Get-CMConfigurationPlatform avec le paramètre Platform , vous pouvez utiliser ce paramètre pour spécifier un tableau d’une ou plusieurs chaînes ModelName connues. Par exemple, modelName pour la plateforme Tous Windows 11 et versions ultérieures (64 bits) est Windows/All_x64_Windows_11_and_higher_Clients.

Utilisez une commande similaire à la suivante pour découvrir le nom du modèle d’une plateforme :

Get-CMConfigurationPlatform -Name "*Server 2019*" -Fast | Select-Object LocalizedDisplayName, ModelName

Type:String[]
Alias:PlatformStrings, PlatformCIUniqueID, PlatformCIUniqueIDs
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RuleOperator

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

Type:RuleExpressionOperator
Valeurs acceptées:OneOf, NoneOf
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SelectFullPlatform

Utilisez ce paramètre pour sélectionner toutes les plateformes du type spécifié.

Type:FullPlatformOption
Valeurs acceptées:Windows, Nokia, WindowsMobile, IOs, IOsDeepLink, Android, AndroidDeepLink, Mac, WinPhone8, WinPhone8DeepLink, MobileMsi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object