New-CMUserCollection

リファレンス

モジュール:: ConfigurationManager

ユーザーコレクションを作成します。

構文

New-CMUserCollection
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMUserCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMUserCollection
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、特定の制限コレクションに基づいてユーザーコレクションを作成します。制限コレクションは、作成するユーザーコレクションのメンバーにできるユーザーを決定します。たとえば、All Users コレクションを制限コレクションとして使用する場合、新しいコレクションには Configuration Manager 階層内の任意のユーザーを含めできます。

その後、メンバーシップルールを使用してコレクションにユーザーを追加できます。ユーザーコレクションにメンバーを追加するには、次のいずれかのメンバーシップルールコマンドレットを使用します。

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

注意

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

例

例 1: ユーザーコレクションを作成する

このコマンドは、営業部門のすべてのユーザーのコレクション を作成 します。 LimitingCollectionNameパラメーターに [すべてのユーザー] を指定すると、新しいコレクションに Configuration Manager 階層内の任意のユーザーを含めできます。 ****

New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"

パラメーター

-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

-InputObject

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

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

-LimitingCollectionId

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

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

-LimitingCollectionName

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

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

-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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object