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>] 説明
New-CMGlobalCondition コマンドレットは、Configuration Managerにグローバル条件を作成します。
グローバル条件は、Configuration Managerの設定または式であり、アプリケーションConfiguration Managerクライアントに対して提供および展開する方法を指定するために使用できます。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。
例
例 1: グローバル条件を作成する
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windowsこのコマンドは、Microsoft.Office.Tools.Word.v9.0 という名前のアセンブリを Windows デバイスで検索するグローバル条件を作成します。
パラメーター
-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
コマンドレットを実行する前に確認メッセージを表示します。
| 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
グローバル条件データ型を指定します。 このパラメーターの有効な値は次のとおりです。
- ブール型
- DateTime
- 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 Domain Services (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
コマンドレットに操作にサブフォルダーが含まれるかどうかを示します。
| 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
検索するレジストリ キー名を指定します。 key\subkey の形式を使用します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapFilter
クライアント コンピューターのコンプライアンスを評価するために AD DS クエリの結果を絞り込むライトウェイト ディレクトリ アクセス プロトコル (LDAP) フィルターを指定します。
| 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
インターネット インフォメーション サービス (IIS) のメタベース ファイルへのパスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
IIS メタベース ファイルの名前を指定します。
| 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
Open Mobile Alliance (OMA) デバイスのデバイス固有のパラメーターを指す Uniform Resource Indicator (URI) を指定します。
| 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
クライアントのコンプライアンスを判断するために使用Configuration Manager AD DS のプロパティを指定します。
| 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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 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
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示