共用方式為


New-CMGlobalCondition

建立 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