New-CMRequirementRuleFileAttributeValue
ファイル属性を確認するための要件ルールを作成します。
構文
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
関連リンク
- New-CMRequirementRuleActiveDirectorySiteValue
- New-CMRequirementRuleBooleanValue
- New-CMRequirementRuleCMSiteValue
- New-CMRequirementRuleCommonValue
- New-CMRequirementRuleDeviceOwnershipValue
- New-CMRequirementRuleExistential
- New-CMRequirementRuleExpression
- New-CMRequirementRuleFilePermissionValue
- New-CMRequirementRuleFreeDiskSpaceValue
- New-CMRequirementRuleInputTypeValue
- New-CMRequirementRuleOperatingSystemLanguageValue
- New-CMRequirementRuleOperatingSystemValue
- New-CMRequirementRuleOUValue
- New-CMRequirementRuleRegistryKeyPermissionValue
- New-CMRequirementRuleScreenResolutionValue
- Get-CMGlobalCondition
- デプロイの種類の要件
- グローバル条件を作成する