New-CMRequirementRuleFreeDiskSpaceValue

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

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

構文

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

説明

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

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

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

注:

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

例

例 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 と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DriverLetter

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

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

ほとんどの場合、既定の [ディスク領域 ] グローバル条件 (例: Get-CMGlobalCondition -Name "Disk space") を使用します。

型:IResultObject
Aliases:GlobalCondition
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PartitionOption

この要件規則で評価するパーティションの種類を指定します。

  • Any: デバイス上の任意のドライブ
  • System: Windows システム ドライブ
  • Special: 特定のドライブ。 DriverLetter パラメーターを使用して、ドライブ文字を指定します。
型:PartitionType
指定可能な値:Any, System, Special
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RuleOperator

オペレーターを指定して、デバイスの設定と予期される値を比較します。

型:RuleExpressionOperator
指定可能な値:IsEquals, NotEquals, GreaterThan, GreaterEquals, LessThan, LessEquals, Between
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Value1

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

型:Int64[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Value2

Betweenのような RuleOperator を使用する場合は、このパラメーターを使用して上限値を指定します。

例:

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

型:Int64
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object