New-CMRequirementRuleFreeDiskSpaceValue

  • Référence
Module:
ConfigurationManager

Créez une règle d’espace disque requis pour un type de déploiement d’application.

Syntaxe

New-CMRequirementRuleFreeDiskSpaceValue
   [-DriverLetter <String>]
   -PartitionOption <PartitionType>
   -RuleOperator <RuleExpressionOperator>
   -Value1 <Int64[]>
   [-Value2 <Int64>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer une règle d’espace disque requis 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 de configuration requise pour l’espace disque

Cet exemple utilise d’abord l’applet de commande Get-CMGlobalCondition pour obtenir la condition globale d’espace disque par défaut. Il crée ensuite l’objet de règle d’exigence pour vérifier que l’espace libre sur le lecteur E : est compris entre 5 Mo et 10 Mo. Enfin, il transmet cet objet de règle à l’applet de commande Set-CMScriptDeploymentType pour ajouter la condition requise.

$value1 = 5

$value2 = 10

$myGC = Get-CMGlobalCondition -Name "Disk space"

$myRule = $myGC | New-CMRequirementRuleFreeDiskSpaceValue -PartitionOption Special -RuleOperator Between -Value1 $value1 -Value2 $value2 -DriverLetter "E:"

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

-DriverLetter

Lorsque vous définissez le paramètre PartitionOption sur Special, utilisez ce paramètre pour spécifier la lettre de lecteur. Par exemple : "C:".

Type:String
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 d’espace disque par défaut, par exemple : Get-CMGlobalCondition -Name "Disk space".

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

-PartitionOption

Spécifiez le type de partition à évaluer avec cette règle d’exigence :

  • Any: n’importe quel lecteur sur l’appareil
  • System: lecteur système Windows
  • Special: lecteur spécifique. Utilisez le paramètre DriverLetter pour spécifier la lettre de lecteur.
Type:PartitionType
Valeurs acceptées:Any, System, Special
Position:Named
Valeur par défaut:None
Obligatoire:True
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:IsEquals, NotEquals, GreaterThan, GreaterEquals, LessThan, LessEquals, Between
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Value1

Spécifiez un entier ou un tableau de valeurs attendues à comparer. Cette valeur correspond à la quantité d’espace libre en mégaoctets (Mo).

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

-Value2

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

Par exemple :

$myRule = New-CMRequirementRuleFreeDiskSpaceValue -InputObject $GC -PartitionOption System -RuleOperator Between -Value1 1024 -Value2 2048

Type:Int64
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