New-CMRequirementRuleFreeDiskSpaceValue

  • リファレンス
モジュール:
ConfigurationManager

アプリケーション展開の種類のディスク領域要件ルールを作成します。

構文

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

説明

このコマンドレットを使用して、アプリケーション展開の種類のディスク領域要件ルールを作成します。

このコマンドレットを使用した後、展開の種類に 対して、Add コマンドレット または Set- コマンドレットのいずれかを使用します。 この要件ルール オブジェクトを AddRequirement パラメーターまたは RemoveRequirement パラメーターに渡 します。

詳細については、「展開の種類 の要件」および「グローバル 条件の 作成」を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: ディスク領域の要件ルールを追加する

この例では、 まず Get-CMGlobalCondition コマンドレットを使用して、既定の ディスク領域グローバル条件を 取得します。 次に、要件ルール オブジェクトを作成して 、E: ドライブの空き領域を 5 MB ~ 10 MB の間で確認します。 最後に、そのルール オブジェクトを Set-CMScriptDeploymentType コマンドレットに渡して要件を追加します。

$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
Accept pipeline input:False
Accept wildcard characters:False
-DriverLetter

PartitionOption パラメーターをに設定する場合 Special は、このパラメーターを使用してドライブ文字を指定します。 たとえば、"C:" などです。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

この要件ルールの基礎として使用するグローバル条件オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMGlobalCondition コマンドレットを使用 します。

ほとんどの場合、既定のディスク領域グローバル条件を使用**** します。たとえば、次のようになります Get-CMGlobalCondition -Name "Disk space" 。

Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
-Value1

比較する必要がある値の整数または配列を指定します。 この値は、メガバイト (MB) の空き領域の量です。

Type:Int64[]
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object