Set-CMGlobalCondition

モジュール:

ConfigurationManager

Configuration Manager グローバル条件の設定を変更します。

構文

Set-CMGlobalCondition
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-AssemblyName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-Class <String>]
   -Name <String>
   [-Namespace <String>]
   [-PassThru]
   [-Property <String>]
   [-WhereClause <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-UseDefaultInstance]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-UseAllInstances]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   [-InstanceName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-DistinguishedName <String>]
   [-LdapFilter <String>]
   [-LdapPrefix <String>]
   -Name <String>
   [-PassThru]
   [-Property <String>]
   [-SearchScope <SearchScope>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-FileOrFolderName <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-Path <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-FilePath <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-ScriptLanguage <ScriptingLanguage>]
   [-Use32BitHost <Boolean>]
   [-UseLoggedOnUserCredential <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-FilePath <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-XmlFilePath <String>]
   [-XmlNamespace <String[]>]
   [-XPathQuery <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-Is64Bit <Boolean>]
   [-KeyName <String>]
   -Name <String>
   [-PassThru]
   [-RegistryHive <RegistryRootKey>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-Is64Bit <Boolean>]
   [-KeyName <String>]
   -Name <String>
   [-PassThru]
   [-RegistryHive <RegistryRootKey>]
   [-ValueName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   [-MetabasePath <String>]
   -Name <String>
   [-PassThru]
   [-PropertyId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMGlobalCondition
   -Name <String>
   -OmaUri <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMGlobalCondition コマンドレットは、グローバル条件の設定を変更します。 グローバル条件のセキュリティ スコープを追加または削除できます。 グローバル条件は、名前または ID で指定することも、 Get-CMGlobalCondition コマンドレットを使用してグローバル条件オブジェクトを取得することもできます。

Configuration Manager では、グローバル条件を使用して、ビジネスまたは技術的な条件を表します。 グローバル条件では、クライアント デバイスにアプリケーションを提供して展開する方法を指定します。

各グローバル条件には、少なくとも 1 つのセキュリティ スコープが必要です。

注:

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

例

例 1: セキュリティ スコープを追加する

PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"

このコマンドは、Scope22 という名前のセキュリティ スコープを CPU 速度という名前のグローバル条件に追加します。

例 2: 変数を使用してセキュリティ スコープを削除する

PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"

最初のコマンドでは 、Get-CMGlobalCondition コマンドレットを使用して、CPU 速度というグローバル条件を取得し、$CMGC変数に格納します。

2 番目のコマンドは、$CMGC変数に格納されているグローバル条件から Scope22 という名前のセキュリティ スコープを削除します。

パラメーター

-AssemblyName

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

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

-Class

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

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

-Column

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

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

-Confirm

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

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

-Database

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

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

-Description

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

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

-DisableWildcardHandling

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

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

-DistinguishedName

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

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

-FileOrFolderName

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

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

-FilePath

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

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

-Is64Bit

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

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

-KeyName

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

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

-LdapFilter

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

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

-LdapPrefix

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

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

-MetabasePath

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

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

-Name

グローバル条件の名前を指定します。 この値は、グローバル条件オブジェクトの LocalizedDisplayName プロパティに対応します。

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

-Namespace

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

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

-NewName

グローバル条件の新しい名前を指定します。

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

-OmaUri

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

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

-PassThru

現在の作業オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

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

-Path

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

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

-Property

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

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

-PropertyId

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

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

-RegistryHive

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

• ClassesRoot
• CurrentConfig
• CurrentUser
• LocalMachine
• ユーザー

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

-ScriptLanguage

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

• PowerShell
• VBScript
• JScript

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

-SearchScope

AD DS の検索スコープを指定します。 このパラメーターの有効な値は次のとおりです。

• Base
• OneLevel
• サブツリー

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

-Use32BitHost

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

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

-UseAllInstances

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

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

-UseDefaultInstance

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

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

-UseLoggedOnUserCredential

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

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

-ValueName

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

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

-XmlNamespace

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

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

-XPathQuery

XPath クエリを指定します。

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

入力

None

出力

System.Object

関連リンク

• New-CMGlobalCondition
• Get-CMGlobalCondition
• Remove-CMGlobalCondition
• Set-CMGlobalCondition
• Set-CMGlobalConditionAssembly
• Set-CMGlobalConditionFile
• Set-CMGlobalConditionIisMetabase
• Set-CMGlobalConditionOmaUri
• Set-CMGlobalConditionRegistryKey
• Set-CMGlobalConditionRegistryValue
• Set-CMGlobalConditionScript
• Set-CMGlobalConditionSqlQuery
• Set-CMGlobalConditionWqlQuery
• Set-CMGlobalConditionXPathQuery