次の方法で共有

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 階層内の任意のデバイスを含めることができます。

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

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

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

注:

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

例

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

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

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

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

パラメーター

-CollectionId

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

型:String
配置: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:Collection
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LimitingCollection

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

型:IResultObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LimitingCollectionId

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

型:String
Aliases:LimitToCollectionId
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LimitingCollectionName

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

型:String
Aliases:LimitToCollectionName
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewName

コレクションの新しい名前を指定します。 名前を変更するには、このパラメーターを使用します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る: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 が最も高くなります。

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

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

型:Int32
Aliases:DeviceCollectionVariablePrecedence
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object