Set-CMGlobalCondition
修改Configuration Manager全局条件的设置。
语法
Set-CMGlobalCondition
[-Description <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-AssemblyName <String>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Class <String>]
-Name <String>
[-Namespace <String>]
[-PassThru]
[-Property <String>]
[-WhereClause <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
-Name <String>
[-PassThru]
[-UseDefaultInstance]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
-Name <String>
[-PassThru]
[-UseAllInstances]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
[-InstanceName <String>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-DistinguishedName <String>]
[-LdapFilter <String>]
[-LdapPrefix <String>]
-Name <String>
[-PassThru]
[-Property <String>]
[-SearchScope <SearchScope>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FileOrFolderName <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-Path <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FilePath <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FilePath <String>]
-Name <String>
[-PassThru]
[-ScriptLanguage <ScriptingLanguage>]
[-Use32BitHost <Boolean>]
[-UseLoggedOnUserCredential <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FilePath <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-XmlFilePath <String>]
[-XmlNamespace <String[]>]
[-XPathQuery <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Is64Bit <Boolean>]
[-KeyName <String>]
-Name <String>
[-PassThru]
[-RegistryHive <RegistryRootKey>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Is64Bit <Boolean>]
[-KeyName <String>]
-Name <String>
[-PassThru]
[-RegistryHive <RegistryRootKey>]
[-ValueName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-MetabasePath <String>]
-Name <String>
[-PassThru]
[-PropertyId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
-Name <String>
-OmaUri <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Set-CMGlobalCondition cmdlet 修改全局条件的设置。 可以添加或删除全局条件的安全范围。 可以按名称或 ID 指定全局条件，也可以使用 Get-CMGlobalCondition cmdlet 获取全局条件对象。
Configuration Manager使用全局条件来表示业务或技术条件。 全局条件指定如何向客户端设备提供和部署应用程序。
每个全局条件必须至少有一个安全作用域。
注意
从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：添加安全作用域
PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"此命令将名为 Scope22 的安全范围添加到名为 CPU 速度的全局条件。
示例 2：使用变量删除安全范围
PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"第一个命令使用 Get-CMGlobalCondition cmdlet 获取名为 CPU 速度的全局条件，并将其存储在 $CMGC 变量中。
第二个命令从存储在 $CMGC 变量中的全局条件中删除名为 Scope22 的安全作用域。
参数
-AssemblyName
指定要搜索的程序集的名称。 程序集名称必须在全局程序集缓存中注册。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Class
指定用于生成 WMI 查询语言 (WQL) 查询的 Windows Management Instrumentation (WMI) 类。 查询评估客户端计算机上的符合性。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Column
指定用于评估全局条件符合性的列名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Database
指定数据库的名称。 SQL 查询在此数据库上运行。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定全局条件的说明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistinguishedName
指定要在客户端计算机上评估符合性的Active Directory 域服务 (AD DS) 对象的可分辨名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileOrFolderName
指定文件或文件夹的名称。 指定 IsFolder 参数以搜索文件夹。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilePath
指定条件评估符合性的文件的文件路径。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeSubfolder
指示 cmdlet 是否在操作中包含子文件夹。
| Type: | Boolean |
| Aliases: | IncludeSubfolders |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceName
指定全局条件搜索的数据库实例的名称。 若要搜索默认实例，请指定 UseDefaultInstance 参数。 若要搜索所有实例，请指定 UseAllInstances 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Is64Bit
指示全局条件搜索 64 位系统文件位置以及 32 位系统文件位置。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-KeyName
指定要搜索的注册表项名称。 使用格式键\子项。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapFilter
指定轻型目录访问协议 (LDAP) 筛选器来优化 AD DS 查询的结果，以评估客户端计算机上的符合性。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapPrefix
为评估客户端计算机上的合规性的 AD DS 查询指定有效的 LDAP 前缀。 此参数的可接受值为：LDAP:// 或 GC://。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MetabasePath
指定 Internet Information Services (IIS) 的元数据库文件的路径。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定全局条件的名称。 此值对应于全局条件对象的 LocalizedDisplayName 属性。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Namespace
指定 WMI 存储库中的命名空间。 默认值为 Root\cimv2。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
指定全局条件的新名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OmaUri
指定统一资源指示器 (URI) ，该 URI 指向 Open Mobile Alliance (OMA) 设备的特定于设备的参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
返回当前工作对象。 默认情况下，此 cmdlet 不生成任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定 OMA URI 的路径。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
指定用于评估客户端计算机上的符合性的 AD DS 对象的属性。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PropertyId
指定Configuration Manager用于确定客户端符合性的 AD DS 的属性。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryHive
指定注册表中标识所搜索的注册表配置单元的根键。 WMI 使用注册表配置单元返回、设置和更改注册表项的值。 此参数可接受的值为：
- ClasssRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- 用户
| Type: | RegistryRootKey |
| Accepted values: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptLanguage
指定要使用的脚本语言。 此参数可接受的值为：
- PowerShell
- VBScript
- JScript
| Type: | ScriptingLanguage |
| Accepted values: | PowerShell, VBScript, JScript, ShellScript |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchScope
指定 AD DS 中的搜索范围。 此参数可接受的值为：
- 基本
- OneLevel
- 子
| Type: | SearchScope |
| Accepted values: | Base, OneLevel, Subtree |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Use32BitHost
指示文件或文件夹与 64 位应用程序相关联。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAllInstances
指示全局条件搜索所有数据库实例。 若要搜索命名实例，请指定 InstanceName 参数。 若要搜索默认实例，请指定 UseDefaultInstance 参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseDefaultInstance
指示全局条件搜索默认数据库实例。 若要搜索命名实例，请指定 InstanceName 参数。 若要搜索所有实例，请指定 UseAllInstances 参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseLoggedOnUserCredential
指示是否使用登录的用户凭据。
| Type: | Boolean |
| Aliases: | UseLoggedOnUserCredentials |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueName
指定要包含在指定注册表项中的值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhereClause
指定要应用于客户端计算机上的指定命名空间、类和属性的 WQL 查询 WHERE 子句。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XmlFilePath
指定一个文件，该文件包含用于评估客户端计算机上的符合性的 XML 查询。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XmlNamespace
指定一组有效的完整 XML 路径语言 (XPath) 查询，用于评估客户端计算机上的符合性。
| Type: | String[] |
| Aliases: | XmlNamespaces |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XPathQuery
指定 XPath 查询。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
None
输出
System.Object
相关链接
- New-CMGlobalCondition
- Get-CMGlobalCondition
- Remove-CMGlobalCondition
- Set-CMGlobalCondition
- Set-CMGlobalConditionAssembly
- Set-CMGlobalConditionFile
- Set-CMGlobalConditionIisMetabase
- Set-CMGlobalConditionOmaUri
- Set-CMGlobalConditionRegistryKey
- Set-CMGlobalConditionRegistryValue
- Set-CMGlobalConditionScript
- Set-CMGlobalConditionSqlQuery
- Set-CMGlobalConditionWqlQuery
- Set-CMGlobalConditionXPathQuery
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈