共用方式為

New-CMRequirementRuleFreeDiskSpaceValue

  • 參考
模組:
ConfigurationManager

建立應用程式部署類型的磁碟空間需求規則。

語法

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

Description

使用此 Cmdlet 建立應用程式部署類型的磁碟空間需求規則。

使用此 Cmdlet 之後，請針對部署類型使用其中一個 Add- 或 Set- Cmdlet。 將此需求規則對象傳遞至 AddRequirement 或 RemoveRequirement 參數。

如需詳細資訊，請 參閱部署類型需求 和 建立全域條件。

注意事項

從 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

如果您使用 RuleOperator ，例如 Between，請使用此參數來指定上限值。

例如：

$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