New-CMRequirementRuleFreeDiskSpaceValue
为应用程序部署类型创建磁盘空间要求规则。
语法
New-CMRequirementRuleFreeDiskSpaceValue
[-DriverLetter <String>]
-PartitionOption <PartitionType>
-RuleOperator <RuleExpressionOperator>
-Value1 <Int64[]>
[-Value2 <Int64>]
[-InputObject] <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
说明
使用此 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
如果使用类似于 Between
的 RuleOperator,请使用此参数指定上限值。
例如:
$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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈