New-CMRequirementRuleFreeDiskSpaceValue
建立應用程式部署類型的磁碟空間需求規則。
Syntax
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結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverLetter
當您將 PartitionOption 參數設定為 Special
時,請使用此參數來指定磁碟機號。 例如,"C:"
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定要作為此需求規則基礎的全域條件物件。 若要取得此物件,請使用 Get-CMGlobalCondition Cmdlet 。
在大部分情況下,您將使用預設的 磁碟空間 全域條件,例如: Get-CMGlobalCondition -Name "Disk space"
。
Type: | IResultObject |
Aliases: | GlobalCondition |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PartitionOption
使用此需求規則指定要評估的資料分割類型:
Any
:裝置上的任何磁片磁碟機System
:Windows 系統磁片磁碟機Special
:特定磁片磁碟機。 使用 DriverLetter 參數來指定磁碟機號。
Type: | PartitionType |
Accepted values: | Any, System, Special |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleOperator
指定操作員,以比較裝置的設定與預期的值。
Type: | RuleExpressionOperator |
Accepted values: | IsEquals, NotEquals, GreaterThan, GreaterEquals, LessThan, LessEquals, Between |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value1
指定要比較之預期值的整數或陣列。 此值是以 MB) 為單位 (MB 的可用空間量。
Type: | Int64[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value2
如果您使用 RuleOperator ,例如 Between
,請使用此參數來指定上限值。
例如:
$myRule = New-CMRequirementRuleFreeDiskSpaceValue -InputObject $GC -PartitionOption System -RuleOperator Between -Value1 1024 -Value2 2048
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object
相關連結
- New-CMRequirementRuleActiveDirectorySiteValue
- New-CMRequirementRuleBooleanValue
- New-CMRequirementRuleCMSiteValue
- New-CMRequirementRuleCommonValue
- New-CMRequirementRuleDeviceOwnershipValue
- New-CMRequirementRuleExistential
- New-CMRequirementRuleExpression
- New-CMRequirementRuleFileAttributeValue
- New-CMRequirementRuleFilePermissionValue
- New-CMRequirementRuleInputTypeValue
- New-CMRequirementRuleOperatingSystemLanguageValue
- New-CMRequirementRuleOperatingSystemValue
- New-CMRequirementRuleOUValue
- New-CMRequirementRuleRegistryKeyPermissionValue
- New-CMRequirementRuleScreenResolutionValue
- Get-CMGlobalCondition
- 部署類型需求
- 建立全域條件
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應