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 でコレクションを作成する方法」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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 コマンドレットを使用する場合と同じです。
| 型: | CollectionType |
| 指定可能な値: | User, Device |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Comment
このコレクションを説明して識別するオプションのコメントを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
制限コレクションのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection、 Get-CMDeviceCollection、または Get-CMUserCollection コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | LimitingCollection |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-LimitingCollectionId
制限コレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012 や SMS00001)。
| 型: | String |
| Aliases: | LimitToCollectionId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LimitingCollectionName
制限コレクションの名前を指定します。
| 型: | String |
| Aliases: | LimitToCollectionName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
新しいコレクションの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RefreshSchedule
RefreshType パラメーターを Periodic または Both に設定する場合は、このパラメーターを使用してスケジュールを設定します。 サイトがコレクション メンバーシップの完全更新を実行する場合の schedule オブジェクトを指定します。 このオブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RefreshType
コレクション メンバーシップの更新方法を指定します。
-
Manual(1): 管理者は、Configuration Manager コンソールまたは Invoke-CMCollectionUpdate コマンドレットを使用して、メンバーシップの更新を手動でトリガーします。 -
Periodic(2): サイトはスケジュールに従って完全な更新を行います。 増分更新は使用されません。 型を指定しない場合、この値が既定値です。 -
Continuous(4): サイトは定期的に新しいリソースを評価し、新しいメンバーを追加します。 この型は 、増分更新とも呼ばれます。 スケジュールに従って完全な更新を行うわけではありません。 -
Both(6):PeriodicとContinuousの両方の組み合わせで、増分更新と完全更新の両方がスケジュールに従って行われます。
PeriodicまたはBothを指定する場合は、RefreshSchedule パラメーターを使用してスケジュールを設定します。
注:
None値 (0) は、機能的にはManualと同じです。
| 型: | CollectionRefreshType |
| 指定可能な値: | None, Manual, Periodic, Continuous, Both |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VariablePriority
デバイス コレクション変数の優先順位に 1 から 9 の整数値を指定します。
1 は最も優先順位が低く、 9 が最も高くなります。
デバイス コレクションに変数を作成するには、 New-CMDeviceCollectionVariable コマンドレットを使用します。
| 型: | Int32 |
| Aliases: | DeviceCollectionVariablePrecedence |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_Collection」を参照してください。