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

説明

New-CMGlobalCondition コマンドレットは、Configuration Manager でグローバル条件を作成します。

グローバル条件は、Configuration Manager でアプリケーションを提供し、クライアントに展開する方法を指定するために使用できる Configuration Manager の設定または式です。

注:

PS XYZ:\>など、Configuration Manager サイトドライブから Configuration Manager コマンドレットを実行します。詳細については、「作業の開始」を参照してください。

例

例 1: グローバル条件を作成する

PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows

このコマンドは、Microsoft.Office.Tools.Word.v9.0 という名前のアセンブリを Windows デバイスで検索するグローバル条件を作成します。

パラメーター

-AllInstances

グローバル条件がすべてのデータベースインスタンスを検索することを示します。名前付きインスタンスを検索するには、 InstanceName パラメーターを指定します。既定のインスタンスを検索するには、 UseDefaultInstance パラメーターを 指定します。

型:	SwitchParameter
Aliases:	UseAllInstances
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AssemblyName

検索するアセンブリの名前を指定します。アセンブリ名は、グローバルアセンブリキャッシュに登録する必要があります。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Class

WMI クエリ言語 (WQL) クエリの作成に使用する Windows Management Instrumentation (WMI) クラスを指定します。このクエリは、クライアントコンピューターのコンプライアンスを評価します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Column

グローバル条件のコンプライアンスを評価するために使用される列名を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Database

データベースの名前を指定します。 SQL クエリは、このデータベースで実行されます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DataType

グローバル条件データ型を指定します。このパラメーターの有効な値は次のとおりです。

ブール型
DateTime
FloatingPoint
整数
IntegerArray
String
StringArray
バージョン

型:	GlobalConditionDataType
指定可能な値:	String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultInstance

グローバル条件が既定のデータベースインスタンスを検索することを示します。名前付きインスタンスを検索するには、 InstanceName パラメーターを指定します。すべてのインスタンスを検索するには、 UseAllInstances パラメーターを 指定します。

型:	SwitchParameter
Aliases:	UseDefaultInstance
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

グローバル条件の説明を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeviceType

このグローバル条件が適用されるデバイスの種類を指定します。このパラメーターに使用できる値は、Nokia、Windows、WindowsMobile です。

型:	GlobalConditionDeviceType
指定可能な値:	Windows, WindowsMobile
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DistinguishedName

クライアントコンピューターのコンプライアンスを評価する Active Directory Domain Services (AD DS) オブジェクトの識別名を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FileOrFolderName

ファイルまたはフォルダーの名前を指定します。フォルダーを検索する IsFolder パラメーターを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FilePath

条件がコンプライアンスを評価するファイルのファイルパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IncludeSubfolder

コマンドレットに操作にサブフォルダーが含まれるかどうかを示します。

型:	Boolean
Aliases:	IncludeSubfolders
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InstanceName

グローバル条件で検索するデータベースインスタンスの名前を指定します。既定のインスタンスを検索するには、 UseDefaultInstance パラメーターを 指定します。すべてのインスタンスを検索するには、 UseAllInstances パラメーターを 指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Is64Bit

グローバル条件が、32 ビットのシステムファイルの場所に加えて、64 ビットのシステムファイルの場所を検索することを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsFolder

グローバル条件がフォルダーを検索することを示します。このパラメーターを選択しない場合、条件はファイルを検索します。 FileOrFolderName パラメーターを使用して、ファイルまたはフォルダーの名前を指定します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyName

検索するレジストリキー名を指定します。 key\subkey の形式を使用します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LdapFilter

クライアントコンピューターのコンプライアンスを評価するために AD DS クエリの結果を絞り込むライトウェイトディレクトリアクセスプロトコル (LDAP) フィルターを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LdapPrefix

クライアントコンピューターのコンプライアンスを評価する AD DS クエリの有効な LDAP プレフィックスを指定します。このプレフィックスは、LDAP:// または GC:// にすることができます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MetabasePath

インターネットインフォメーションサービス (IIS) のメタベースファイルへのパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

IIS メタベースファイルの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Namespace

WMI リポジトリからの名前空間を指定します。既定値は Root\cimv2 です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OmaUri

Open Mobile Alliance (OMA) デバイスのデバイス固有のパラメーターを指す Uniform Resource Indicator (URI) を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

OMA URI のパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Property

クライアントコンピューターでのコンプライアンスの評価に使用される AD DS オブジェクトのプロパティを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PropertyId

Configuration Manager がクライアントのコンプライアンスを判断するために使用する AD DS のプロパティを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RegistryHive

検索するレジストリハイブを識別するレジストリのルートキーを指定します。 WMI はレジストリハイブを使用して、レジストリキーの値を返し、設定し、変更します。このパラメーターの有効な値は次のとおりです。

ClassesRoot
CurrentConfig
CurrentUser
LocalMachine
ユーザー

型:	RegistryRootKey
指定可能な値:	ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScriptLanguage

使用するスクリプト言語を指定します。このパラメーターの有効な値は次のとおりです。

PowerShell
VBScript
JScript

型:	ScriptingLanguage
指定可能な値:	PowerShell, VBScript, JScript, ShellScript
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SearchScope

AD DS の検索スコープを指定します。このパラメーターで使用できる値は、Base、OneLevel、および Subtree です。

型:	SearchScope
指定可能な値:	Base, OneLevel, Subtree
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Use32BitHost

ファイルまたはフォルダーが 64 ビットアプリケーションに関連付けられていることを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseLoggedOnUserCredential

ログオンしているユーザー資格情報を使用するかどうかを示します。

型:	Boolean
Aliases:	UseLoggedOnUserCredentials
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ValueName

指定したレジストリキーに含める値を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhereClause

クライアントコンピューター上の指定された名前空間、クラス、およびプロパティに適用する WQL クエリ WHERE 句を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-XmlFilePath

クライアントコンピューターのコンプライアンスを評価するために使用する XML クエリを含むファイルを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-XmlNamespace

クライアントコンピューターでのコンプライアンスの評価に使用する有効な完全な XML パス言語 (XPath) クエリの配列を指定します。

型:	String[]
Aliases:	XmlNamespaces
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-XPathQuery

XPath クエリを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

IResultObject

次の方法で共有