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>]

Description

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

指定全域條件數據類型。 此參數可接受的值為：

• 布林值
• DateTime
• FloatingPoint
• 整數
• IntegerArray
• 字串
• 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 Domain Services (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

表示全域條件除了搜尋 32 位系統檔案位置之外，還會搜尋 64 位系統檔案位置。

類型:	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) 的 Metabase 檔案路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定 IIS Metabase 檔案的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Namespace

指定來自 WMI 存放庫的命名空間。 默認值為 Root\cimv2。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OmaUri

指定統一資源指標 (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 會使用登錄區來傳回、設定及變更登錄機碼的值。 此參數可接受的值為：

• ClassesRoot
• 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