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 がアプリケーションをクライアントに提供および展開する方法を指定するために使用できます。

注意

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

例

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

-AssemblyName

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

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

-Class

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

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

-Column

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

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

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

-DataType

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

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

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

-DefaultInstance

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

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

-Description

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

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

-DeviceType

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

Type:	GlobalConditionDeviceType
Accepted values:	Windows, WindowsMobile
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-DistinguishedName

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

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

-FileOrFolderName

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

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

-FilePath

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

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-IncludeSubfolder

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

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

-InstanceName

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

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

-Is64Bit

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

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

-IsFolder

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

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

-KeyName

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

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

-LdapFilter

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

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

-LdapPrefix

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

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

-MetabasePath

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

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

-Name

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

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

-Namespace

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

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

-OmaUri

Open Mobile Alliance (OMA) デバイスのデバイス固有のパラメーターをポイントする統一リソース インジケーター (URI) を指定します。

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

-Path

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

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

-Property

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

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

-PropertyId

Configuration Manager がクライアントのコンプライアンスをADする DS のプロパティを指定します。

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

-SearchScope

DS の検索範囲をADします。 このパラメーターに使用できる値は、Base、OneLevel、および Subtree です。

Type:	SearchScope
Accepted values:	Base, OneLevel, Subtree
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Use32BitHost

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

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

-UseLoggedOnUserCredential

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

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

-ValueName

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhereClause

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

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

-XmlFilePath

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

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

-XmlNamespace

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

Type:	String[]
Aliases:	XmlNamespaces
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-XPathQuery

XPath クエリを指定します。

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

入力

なし

出力

IResultObject

関連リンク

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