New-CMRequirementRuleFileAttributeValue

  • 参考
模块:
ConfigurationManager

创建要求规则以验证文件属性。

语法

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

说明

使用此 cmdlet 对验证文件属性的应用程序部署类型创建要求规则。 例如， “隐藏” 或 “只读”。 它需要数据类型 为 File 的自定义全局条件。

提示

为了进行比较，如果在 Configuration Manager 控制台中手动创建此要求规则，请选择以下选项：

  • 类别： 自定义
  • 条件：选择数据类型为“文件”的自定义全局条件
  • 规则类型： 值
  • 属性： 属性

使用此 cmdlet 后，请对部署类型使用 Add- 或 Set- cmdlet 之一。 将此要求规则对象传递给 AddRequirement 或 RemoveRequirement 参数。

有关详细信息，请参阅 部署类型要求 和 创建全局条件。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1

此示例首先使用 Get-CMGlobalCondition cmdlet 获取自定义全局条件。 接下来，它会创建要求规则对象，以检查文件是否已打开存档、隐藏和系统位。 最后，它将该规则对象传递给 Set-CMScriptDeploymentType cmdlet 以添加要求。

$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
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileArchive

将此参数设置为 On 以验证文件的 存档 位。 默认情况下，条件不验证 属性。

类型:AttributeVerificationOption
接受的值:On, Off, DoNotVerify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileCompressed

将此参数设置为 On 以验证文件的 压缩 位。 默认情况下，条件不验证 属性。

类型:AttributeVerificationOption
接受的值:On, Off, DoNotVerify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileEncrypted

将此参数设置为 On 以验证文件上的 Encrypted 位。 默认情况下，条件不验证 属性。

类型:AttributeVerificationOption
接受的值:On, Off, DoNotVerify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileHidden

将此参数设置为 On 以验证文件上的 Hidden 位。 默认情况下，条件不验证 属性。

类型:AttributeVerificationOption
接受的值:On, Off, DoNotVerify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileReadOnly

将此参数设置为 On 以验证文件上的 只读 位。 默认情况下，条件不验证 属性。

类型:AttributeVerificationOption
接受的值:On, Off, DoNotVerify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileSystem

将此参数设置为 以 On 验证文件上的 系统 位。 默认情况下，条件不验证 属性。

类型:AttributeVerificationOption
接受的值:On, Off, DoNotVerify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要用作此要求规则基础的自定义全局条件对象。 若要获取此对象，请使用 Get-CMGlobalCondition cmdlet。

若要查看站点中可用 文件 全局条件的列表，请使用以下 PowerShell 命令：

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

类型:IResultObject
别名:GlobalCondition
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object