New-CMRequirementRuleFreeDiskSpaceValue

为应用程序部署类型创建磁盘空间要求规则。

语法

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

说明

使用此 cmdlet 为应用程序部署类型创建磁盘空间要求规则。

使用此 cmdlet 后,请对部署类型使用 Add-Set- cmdlet 之一。 将此要求规则对象传递给 AddRequirementRemoveRequirement 参数。

有关详细信息,请参阅 部署类型要求创建全局条件

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:添加磁盘空间要求规则

此示例首先使用 Get-CMGlobalCondition cmdlet 获取默认 的磁盘空间 全局条件。 然后,它会创建要求规则对象,以检查 E: 驱动器上的可用空间在 5 MB 到 10 MB 之间。 最后,它将该规则对象传递给 Set-CMScriptDeploymentType cmdlet 以添加要求。

$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

参数

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DriverLetter

PartitionOption 参数设置为 Special时,使用此参数指定驱动器号。 例如,"C:"

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要用作此要求规则基础的全局条件对象。 若要获取此对象,请使用 Get-CMGlobalCondition cmdlet。

在大多数情况下,将使用默认 的磁盘空间 全局条件,例如: Get-CMGlobalCondition -Name "Disk space"

类型:IResultObject
别名:GlobalCondition
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PartitionOption

使用此要求规则指定要评估的分区类型:

  • Any:设备上的任意驱动器
  • System:Windows 系统驱动器
  • Special:特定驱动器。 使用 DriverLetter 参数指定驱动器号。
类型:PartitionType
接受的值:Any, System, Special
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RuleOperator

指定运算符以将设备的设置与预期值进行比较。

类型:RuleExpressionOperator
接受的值:IsEquals, NotEquals, GreaterThan, GreaterEquals, LessThan, LessEquals, Between
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Value1

指定要比较的预期值的整数或数组。 此值是可用空间量(以 MB (MB) 为单位)。

类型:Int64[]
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Value2

如果使用类似于 Between的 RuleOperator,请使用此参数指定上限值。

例如:

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

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object