Set-CMCollection

モジュール:

ConfigurationManager

デバイスまたはユーザー コレクションを構成します。

構文

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、デバイスまたはユーザー コレクションを構成します。

制限コレクションは、コレクションのメンバーにできるリソースを決定します。 たとえば、All Systems コレクションを制限コレクションとして使用する場合、新しいコレクションには Configuration Manager 階層内の任意のデバイスを含めできます。

メンバーシップ ルールを使用してコレクションにリソースを追加します。 メンバーをコレクションに追加するには、次のいずれかのコマンドレットを使用してメンバーシップ ルールを追加します。

• Add-CMDeviceCollectionQueryMembershipRule
• Add-CMUserCollectionQueryMembershipRule

既定のコレクションを構成できない。 ターゲットとするコレクションには、サイト コードで始まる ID を持つ必要があります SMS 。

詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。

注意

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

例

例 1: コレクションの名前を変更する

最初のコマンドは testUser という名前のコレクション オブジェクトを取得し、そのコレクション オブジェクト を 変数 $userCollectionします。

2 番目のコマンドは、コレクションの名前を更新します。

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

パラメーター

-CollectionId

構成するコレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012 、 です。 既定のコレクションを構成できないので、この値はサイト コードではなく、サイト コードで始まります SMS 。

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

-Comment

このコレクションを説明して識別するオプションのコメントを指定します。

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

-DisableWildcardHandling

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

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

-InputObject

構成するコレクション オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollectionコマンドレット 、Get-CMDeviceCollectionコマンドレット、 または Get-CMUserCollection コマンドレットを使用します。

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LimitingCollection

制限コレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollectionコマンドレット 、Get-CMDeviceCollectionコマンドレット、 または Get-CMUserCollection コマンドレットを使用します。

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

-LimitingCollectionId

制限コレクションの ID を指定します。 この値は 、CollectionID プロパティです 。たとえば XYZ00012 、または SMS00001 .

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

-LimitingCollectionName

制限コレクションの名前を指定します。

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

-Name

構成するコレクションの名前を指定します。

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

-PassThru

このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-RefreshSchedule

RefreshTypeパラメーターをどちらかまたはに設定する場合は Periodic 、この Both パラメーターを使用してスケジュールを設定します。 サイトでコレクション メンバーシップの完全な更新を実行するスケジュール オブジェクトを指定します。 このオブジェクトを取得するには 、New-CMSchedule コマンドレットを使用 します。

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

-RefreshType

コレクション メンバーシップの更新方法を指定します。

• Manual (1): 管理者は、Configuration Manager コンソールまたは Invoke-CMCollectionUpdate コマンドレットでメンバーシップ更新プログラムを手動でトリガーします。
• Periodic (2): サイトはスケジュールに合った完全な更新を行います。 増分更新プログラムは使用しない。 型を指定しない場合は、この値が既定です。
• Continuous (4): サイトは定期的に新しいリソースを評価し、新しいメンバーを追加します。 この型は、増分更新とも_呼ばれる。_ スケジュールに合った完全な更新は行わない。
• Both (6): 増分更新とスケジュールの完全な更新の両方を組み Periodic Continuous 合わせて使用します。

またはを指定する Periodic 場合 Both は 、RefreshSchedule パラメーターを使用してスケジュールを設定します。

注意

値 None (0) は、 と機能的に同じです Manual 。

Type:	CollectionRefreshType
Accepted values:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VariablePriority

デバイス コレクション変数の優先度に 1 ~ 9 の整数値を指定します。 1 は優先度が最も低く、 9 最も高くなります。

デバイス コレクションで変数を構成するには 、Set-CMDeviceCollectionVariable コマンドレットを使用 します。

現在の変数の優先度を表示するには 、Get-CMCollectionSetting コマンドレットを使用 します。

Type:	Int32
Aliases:	DeviceCollectionVariablePrecedence
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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Copy-CMCollection
• Export-CMCollection
• Get-CMCollection
• Get-CMCollectionMember
• Get-CMCollectionSetting
• Import-CMCollection
• Invoke-CMCollectionUpdate
• New-CMCollection
• Remove-CMCollection
• Set-CMCollection
• Set-CMDeviceCollectionVariable
• Get-CMDeviceCollection
• Get-CMUserCollection
• Configuration Manager でコレクションを作成する方法