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 つのセキュリティ スコープが必要です。

注意

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

例

例 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 番目のコマンドは、Scope22 という名前のセキュリティ スコープを、変数に格納されているグローバル条件$CMGCします。

パラメーター

-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

-Description

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

Type:	String
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

-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

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

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

-NewName

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

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

-PassThru

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

Type:	SwitchParameter
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
• サブツリー

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

-UseAllInstances

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

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

-UseDefaultInstance

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

Type:	SwitchParameter
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

入力

なし

出力

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