New-CMGlobalCondition

模块:

ConfigurationManager

创建 Configuration Manager 全局条件对象。

语法

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -DistinguishedName <String>
   -LdapFilter <String>
   [-LdapPrefix <String>]
   -Name <String>
   -Property <String>
   -SearchScope <SearchScope>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-AllInstances]
   -Column <String>
   -Database <String>
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -AssemblyName <String>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -Class <String>
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   [-Namespace <String>]
   -Property <String>
   [-WhereClause <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -Column <String>
   -Database <String>
   -DataType <GlobalConditionDataType>
   [-DefaultInstance]
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -Column <String>
   -Database <String>
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -InstanceName <String>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   [-MetabasePath <String>]
   -Name <String>
   -PropertyId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   [-Is64Bit <Boolean>]
   -KeyName <String>
   -Name <String>
   -RegistryHive <RegistryRootKey>
   -ValueName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -Name <String>
   -ScriptLanguage <ScriptingLanguage>
   [-Use32BitHost <Boolean>]
   [-UseLoggedOnUserCredential <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-XmlNamespace <String[]>]
   -XPathQuery <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   -XmlFilePath <String>
   [-XmlNamespace <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   -OmaUri <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FileOrFolderName <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   [-IsFolder]
   -Name <String>
   -Path <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   [-Is64Bit <Boolean>]
   -KeyName <String>
   -Name <String>
   -RegistryHive <RegistryRootKey>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-CMGlobalCondition cmdlet 在 Configuration Manager 中创建全局条件。

全局条件是 Configuration Manager 中的一个设置或表达式，可用于指定 Configuration Manager 如何向客户端提供和部署应用程序。

注意

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

示例

示例 1：创建全局条件

PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows

此命令创建一个全局条件，用于在 Windows 设备上搜索名为 Microsoft.Office.Tools.Word.v9.0 的程序集。

参数

-AllInstances

指示全局条件搜索所有数据库实例。 若要搜索命名实例，请指定 InstanceName 参数。 若要搜索默认实例，请指定 UseDefaultInstance 参数。

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

-AssemblyName

指定要搜索的程序集的名称。 程序集名称必须在全局程序集缓存中注册。

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

-Class

指定用于生成 WMI 查询语言 (WQL) 查询的 Windows Management Instrumentation (WMI) 类。 查询评估客户端计算机上的符合性。

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

-Column

指定用于评估全局条件符合性的列名称。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Database

指定数据库的名称。 SQL 查询在此数据库上运行。

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

-DataType

指定全局条件数据类型。 此参数可接受的值为：

• 布尔值
• 日期时间
• FloatingPoint
• 整数
• IntegerArray
• String
• StringArray
• 版本

类型:	GlobalConditionDataType
接受的值:	String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DefaultInstance

指示全局条件搜索默认数据库实例。 若要搜索命名实例，请指定 InstanceName 参数。 若要搜索所有实例，请指定 UseAllInstances 参数。

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

-Description

指定全局条件的说明。

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

-DeviceType

指定应用此全局条件的设备类型。 此参数的可接受值为：Nokia、Windows 和 WindowsMobile。

类型:	GlobalConditionDeviceType
接受的值:	Windows, WindowsMobile
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-DistinguishedName

指定 Active Directory 域服务 (AD DS) 对象的可分辨名称，以评估客户端计算机上的符合性。

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

-FileOrFolderName

指定文件或文件夹的名称。 指定 IsFolder 参数以搜索文件夹。

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

-FilePath

指定条件评估符合性的文件的文件路径。

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

-ForceWildcardHandling

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

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

-IncludeSubfolder

指示 cmdlet 是否在操作中包含子文件夹。

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

-InstanceName

指定全局条件搜索的数据库实例的名称。 若要搜索默认实例，请指定 UseDefaultInstance 参数。 若要搜索所有实例，请指定 UseAllInstances 参数。

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

-Is64Bit

指示全局条件搜索 64 位系统文件位置以及 32 位系统文件位置。

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

-IsFolder

指示全局条件搜索文件夹。 如果未选择此参数，则条件将搜索文件。 使用 FileOrFolderName 参数指定文件或文件夹的名称。

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

-KeyName

指定要搜索的注册表项名称。 使用格式键\子项。

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

-LdapFilter

指定轻型目录访问协议 (LDAP) 筛选器来优化 AD DS 查询的结果，以评估客户端计算机上的符合性。

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

-LdapPrefix

为评估客户端计算机上的合规性的 AD DS 查询指定有效的 LDAP 前缀。 此前缀可以是 LDAP:// 或 GC://。

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

-MetabasePath

指定 Internet Information Services (IIS) 的元数据库文件的路径。

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

-Name

指定 IIS 元数据库文件的名称。

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

-Namespace

指定 WMI 存储库中的命名空间。 默认值为 Root\cimv2。

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

-OmaUri

指定统一资源指示器 (URI) ，该 URI 指向 Open Mobile Alliance (OMA) 设备的特定于设备的参数。

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

-Path

指定 OMA URI 的路径。

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

-Property

指定用于评估客户端计算机上的符合性的 AD DS 对象的属性。

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

-PropertyId

指定 Configuration Manager 用于确定客户端符合性的 AD DS 的属性。

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

-RegistryHive

指定注册表中标识所搜索的注册表配置单元的根键。 WMI 使用注册表配置单元返回、设置和更改注册表项的值。 此参数可接受的值为：

• ClasssRoot
• CurrentConfig
• CurrentUser
• LocalMachine
• 用户

类型:	RegistryRootKey
接受的值:	ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ScriptLanguage

指定要使用的脚本语言。 此参数可接受的值为：

• PowerShell
• VBScript
• JScript

类型:	ScriptingLanguage
接受的值:	PowerShell, VBScript, JScript, ShellScript
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SearchScope

指定 AD DS 中的搜索范围。 此参数的可接受值为：Base、OneLevel 和 Subtree。

类型:	SearchScope
接受的值:	Base, OneLevel, Subtree
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Use32BitHost

指示文件或文件夹与 64 位应用程序相关联。

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

-UseLoggedOnUserCredential

指示是否使用登录的用户凭据。

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

-ValueName

指定要包含在指定注册表项中的值。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。

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

-WhereClause

指定要应用于客户端计算机上指定的命名空间、类和属性的 WQL 查询 WHERE 子句。

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

-XmlFilePath

指定一个文件，该文件包含用于评估客户端计算机上的符合性的 XML 查询。

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

-XmlNamespace

指定一组有效的完整 XML 路径语言 (XPath) 查询，用于评估客户端计算机上的符合性。

类型:	String[]
别名:	XmlNamespaces
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-XPathQuery

指定 XPath 查询。

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

输入

None

输出

IResultObject

相关链接

• Get-CMGlobalCondition
• Set-CMGlobalCondition
• Remove-CMGlobalCondition