New-CMRequirementRuleFileAttributeValue

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

ファイル属性を確認するための要件ルールを作成します。

構文

New-CMRequirementRuleFileAttributeValue
   [-FileArchive <AttributeVerificationOption>]
   [-FileCompressed <AttributeVerificationOption>]
   [-FileEncrypted <AttributeVerificationOption>]
   [-FileHidden <AttributeVerificationOption>]
   [-FileReadOnly <AttributeVerificationOption>]
   [-FileSystem <AttributeVerificationOption>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

このコマンドレットを使用して、ファイル属性を検証するアプリケーション展開の種類に対して要件ルールを作成します。 たとえば、 非表示 または 読み取り専用です。 データ型 File のカスタム グローバル条件が必要です。

ヒント

比較のために、Configuration Manager コンソールでこの要件規則を手動で作成する場合は、次のオプションを選択します。

  • カテゴリ: カスタム
  • 条件: データ型 File のカスタム グローバル条件を選択 します
  • ルールの種類: 値
  • プロパティ: 属性

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

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

注:

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

例

例 1

この例では、最初に Get-CMGlobalCondition コマンドレットを使用して、カスタム グローバル条件を取得します。 次に、ファイルにアーカイブ、非表示、およびシステム ビットがオンになっていることを確認するための要件ルール オブジェクトが作成されます。 最後に、その規則オブジェクトを Set-CMScriptDeploymentType コマンドレットに渡して、要件を追加します。

$myGC = Get-CMGlobalCondition -Name "pagefile.sys"
$myRule = New-CMRequirementRuleFileAttributeValue -GlobalCondition $myGC -FileArchive On -FileHidden On -FileSystem On

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

パラメーター

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-FileArchive

ファイルのアーカイブ ビットを確認するには、このパラメーターを On に設定します。 既定では、条件は属性を検証しません。

型:AttributeVerificationOption
指定可能な値:On, Off, DoNotVerify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileCompressed

ファイルの圧縮ビットを確認するには、このパラメーターを On に設定します。 既定では、条件は属性を検証しません。

型:AttributeVerificationOption
指定可能な値:On, Off, DoNotVerify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileEncrypted

ファイルの暗号化されたビットを確認するには、このパラメーターを On に設定します。 既定では、条件は属性を検証しません。

型:AttributeVerificationOption
指定可能な値:On, Off, DoNotVerify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileHidden

ファイルの非表示ビットを確認するには、このパラメーターを On に設定します。 既定では、条件は属性を検証しません。

型:AttributeVerificationOption
指定可能な値:On, Off, DoNotVerify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileReadOnly

ファイルの読み取り専用ビットを確認するには、このパラメーターを On に設定します。 既定では、条件は属性を検証しません。

型:AttributeVerificationOption
指定可能な値:On, Off, DoNotVerify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileSystem

このパラメーターを On に設定して、ファイルの システム ビットを確認します。 既定では、条件は属性を検証しません。

型:AttributeVerificationOption
指定可能な値:On, Off, DoNotVerify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

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

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

-InputObject

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

サイトで使用可能な ファイル グローバル条件の一覧を表示するには、次の PowerShell コマンドを使用します。

Get-CMGlobalCondition | Where-Object DataType -eq "File" | Select-Object LocalizedDisplayName

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object