New-CMGlobalCondition

模組:

ConfigurationManager

建立Configuration Manager全域條件物件。

Syntax

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 參數。

Type:	SwitchParameter
Aliases:	UseAllInstances
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AssemblyName

指定要搜尋的元件名稱。 元件名稱必須在全域組件快取中註冊。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Class

指定用來建置 WMI 查詢 (WQL) 查詢的 Windows Management Instrumentation (WMI) 類別。 查詢會評估用戶端電腦上的合規性。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Column

指定用來評估全域條件合規性的資料行名稱。

Type:	String
Position:	Named
Default value:	None
Required:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DataType

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

• 布林值
• 日期時間
• FloatingPoint
• 整數
• IntegerArray
• 字串
• StringArray
• 版本

Type:	GlobalConditionDataType
Accepted values:	String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultInstance

表示全域條件會搜尋預設資料庫實例。 若要搜尋具名實例，請指定 InstanceName 參數。 若要搜尋所有實例，請指定 UseAllInstances 參數。

Type:	SwitchParameter
Aliases:	UseDefaultInstance
Position:	Named
Default value:	None
Required:	True
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

-DeviceType

指定套用此全域條件的裝置類型。 此參數可接受的值為：Nokia、Windows 和 WindowsMobile。

Type:	GlobalConditionDeviceType
Accepted values:	Windows, WindowsMobile
Position:	Named
Default value:	None
Required:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FileOrFolderName

指定檔案或資料夾的名稱。 指定 IsFolder 參數來搜尋資料夾。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

指定條件評估相容性之檔案的檔案路徑。

Type:	String
Position:	Named
Default value:	None
Required:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Is64Bit

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IsFolder

表示全域條件會搜尋資料夾。 如果您未選取此參數，條件會搜尋檔案。 使用 FileOrFolderName 參數指定檔案或資料夾的名稱。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyName

指定要搜尋的登錄機碼名稱。 使用格式索引鍵\子機碼。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LdapFilter

指定輕量型目錄存取通訊協定 (LDAP) 篩選器，以精簡 AD DS 查詢的結果，以評估用戶端電腦上的合規性。

Type:	String
Position:	Named
Default value:	None
Required:	True
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) 的 Metabase 檔案路徑。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定 IIS Metabase 檔案的名稱。

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

-OmaUri

指定統一資源指標 (URI) ，指向 Open Mobile Alliance (OMA) 裝置的裝置特定參數。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

指定 OMA URI 的路徑。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

指定用來評估用戶端電腦上合規性之 AD DS 物件的 屬性。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PropertyId

指定 AD DS 的 屬性，Configuration Manager用來判斷用戶端合規性。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RegistryHive

指定登錄中的根金鑰，以識別您所搜尋的登錄區。 WMI 會使用登錄區來傳回、設定及變更登錄機碼的值。 此參數可接受的值為：

• ClassesRoot
• CurrentConfig
• CurrentUser
• LocalMachine
• 使用者

Type:	RegistryRootKey
Accepted values:	ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:	Named
Default value:	None
Required:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SearchScope

指定 AD DS 中的搜尋範圍。 此參數可接受的值為：Base、OneLevel 和 Subtree。

Type:	SearchScope
Accepted values:	Base, OneLevel, Subtree
Position:	Named
Default value:	None
Required:	True
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

-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:	True
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:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

None

輸出

IResultObject

相關連結

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