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>]
Description
Set-CMGlobalCondition Cmdlet會修改全域條件的設定。 您可以新增或移除全域條件的安全性範圍。 您可以依名稱或識別碼指定全域條件,或使用 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
指定要搜尋的元件名稱。 元件名稱必須在全域組件快取中註冊。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Class
指定用來建置 WMI 查詢 (WQL) 查詢的 Windows Management Instrumentation (WMI) 類別。 查詢會評估用戶端電腦上的合規性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Column
指定用來評估全域條件合規性的資料行名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Database
指定資料庫的名稱。 SQL 查詢會在此資料庫上執行。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Description
指定全域條件的描述。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DistinguishedName
指定Active Directory 網域服務 (AD DS) 物件的辨別名稱,以評估用戶端電腦上的合規性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-FileOrFolderName
指定檔案或資料夾的名稱。 指定 IsFolder 參數來搜尋資料夾。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-FilePath
指定條件評估相容性之檔案的檔案路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | 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 |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Is64Bit
表示全域條件除了搜尋 32 位系統檔案位置之外,還會搜尋 64 位系統檔案位置。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-KeyName
指定要搜尋的登錄機碼名稱。 使用格式索引鍵\子機碼。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-LdapFilter
指定輕量型目錄存取通訊協定 (LDAP) 篩選器,以精簡 AD DS 查詢的結果,以評估用戶端電腦上的合規性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-LdapPrefix
指定 AD DS 查詢的有效 LDAP 前置詞,以評估用戶端電腦上的合規性。 此參數可接受的值為:LDAP:// 或 GC://。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MetabasePath
指定 Internet Information Services (IIS) 的 Metabase 檔案路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定全域條件的名稱。 這個值會對應至全域條件物件的 LocalizedDisplayName 屬性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Namespace
指定來自 WMI 存放庫的命名空間。 預設值為 Root\cimv2。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NewName
指定全域條件的新名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-OmaUri
指定統一資源指標 (URI) ,指向 Open Mobile Alliance (OMA) 裝置的裝置特定參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-PassThru
傳回目前的工作物件。 根據預設,這個 Cmdlet 不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
指定 OMA URI 的路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Property
指定用來評估用戶端電腦上合規性之 AD DS 物件的 屬性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PropertyId
指定 AD DS 的 屬性,Configuration Manager用來判斷用戶端合規性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RegistryHive
指定登錄中的根金鑰,以識別您所搜尋的登錄區。 WMI 會使用登錄區來傳回、設定及變更登錄機碼的值。 此參數可接受的值為:
- ClassesRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- 使用者
類型: | RegistryRootKey |
接受的值: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ScriptLanguage
指定要使用的指令碼語言。 此參數可接受的值為:
- PowerShell
- VBScript
- JScript
類型: | ScriptingLanguage |
接受的值: | PowerShell, VBScript, JScript, ShellScript |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SearchScope
指定 AD DS 中的搜尋範圍。 此參數可接受的值為:
- Base
- OneLevel
- 子
類型: | SearchScope |
接受的值: | Base, OneLevel, Subtree |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Use32BitHost
表示檔案或資料夾與 64 位應用程式相關聯。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UseAllInstances
表示全域條件會搜尋所有資料庫實例。 若要搜尋具名實例,請指定 InstanceName 參數。 若要搜尋預設實例,請指定 UseDefaultInstance 參數。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UseDefaultInstance
表示全域條件會搜尋預設資料庫實例。 若要搜尋具名實例,請指定 InstanceName 參數。 若要搜尋所有實例,請指定 UseAllInstances 參數。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UseLoggedOnUserCredential
指出是否要使用登入的使用者認證。
類型: | Boolean |
別名: | UseLoggedOnUserCredentials |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ValueName
指定要包含在指定登錄機碼中的值。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | 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 |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-XmlNamespace
指定有效的完整 XML 路徑語言陣列 (XPath) 查詢,用來評估用戶端電腦上的合規性。
類型: | String[] |
別名: | XmlNamespaces |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-XPathQuery
指定 XPath 查詢。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | 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
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應