New-CMCollection
デバイスまたはユーザー コレクションを作成します。
構文
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、デバイスまたはユーザー コレクションを作成します。
制限コレクションは、作成するコレクションのメンバーにできるリソースを決定します。 たとえば、All Systems コレクションを制限コレクションとして使用する場合、デバイス コレクションの場合、新しいデバイス コレクションには Configuration Manager 階層内の任意のデバイスを含めできます。
作成するコレクションの種類を範囲指定するには 、New-CMDeviceCollection コマンドレットまたは New-CMUserCollection コマンドレットを使用することもできます。
コレクションを作成した後、メンバーシップ ルールを使用してコレクションにリソースを追加します。 メンバーをコレクションに追加するには、次のいずれかのコマンドレットを使用してメンバーシップ ルールを追加します。
詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: ユーザー コレクションを作成する
このコマンドは、すべてのユーザー コレクションを制限コレクションとして設定**** するtestUserという名前のユーザー コレクションを作成します。
New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
例 2: パイプラインを使用して制限コレクションを設定する
このコマンドは、 まず Get-CMCollection を使用して All Users コレクション オブジェクトを 取得します。 次に、パイプライン 演算子を使用してオブジェクトを New-CMCollection コマンドレットに渡し、testUser という名前のコレクション を作成します。 新しい testUser コレクションの制限コレクションは 、All Users コレクション です。
Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
パラメーター
-CollectionType
作成するコレクションの種類を指定します。 このパラメーターは 、New-CMDeviceCollection コマンドレットまたは New-CMUserCollection コマンドレットの使用と機能的に同じです。
Type: | CollectionType |
Accepted values: | User, Device |
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: | LimitingCollection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
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 |
-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
最も高くなります。
デバイス コレクションに変数を作成するには 、New-CMDeviceCollectionVariable コマンドレットを使用 します。
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
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_Collection WMI クラス」を参照してください。