Set-CMCollection
デバイスまたはユーザー コレクションを構成します。
構文
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でコレクションを作成する方法」を参照してください。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>
)。 詳細については、「作業の 開始」を参照してください。
例
例 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comment
このコレクションを説明して識別するオプションのコメントを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
構成するコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection、 Get-CMDeviceCollection、または Get-CMUserCollection コマンドレットを 使用します。
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LimitingCollection
制限コレクションのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection、 Get-CMDeviceCollection、または Get-CMUserCollection コマンドレットを 使用します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LimitingCollectionId
制限コレクションの ID を指定します。 この値は CollectionID プロパティです (例: XYZ00012
または SMS00001
)。
Type: | String |
Aliases: | LimitToCollectionId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LimitingCollectionName
制限コレクションの名前を指定します。
Type: | String |
Aliases: | LimitToCollectionName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
構成するコレクションの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
コレクションの新しい名前を指定します。 名前を変更するには、このパラメーターを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshSchedule
RefreshType パラメーターを または Both
に設定したPeriodic
場合は、このパラメーターを使用してスケジュールを設定します。 サイトがコレクション メンバーシップの完全更新を実行する場合の schedule オブジェクトを指定します。 このオブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RefreshType
コレクション メンバーシップの更新方法を指定します。
Manual
(1): 管理者は、Configuration Manager コンソールまたは Invoke-CMCollectionUpdate コマンドレットを使用して、メンバーシップの更新を手動でトリガーします。Periodic
(2): サイトはスケジュールに従って完全な更新を行います。 増分更新は使用されません。 型を指定しない場合、この値が既定値です。Continuous
(4): サイトは定期的に新しいリソースを評価し、新しいメンバーを追加します。 この型は 増分更新とも呼ばれます。 スケジュールに従って完全な更新を行うわけではありません。Both
(6): と の両方Periodic
Continuous
の組み合わせで、増分更新と完全更新の両方がスケジュールに従って行われます。
または Both
のいずれかをPeriodic
指定する場合は、RefreshSchedule パラメーターを使用してスケジュールを設定します。
注:
None
値 (0) は、機能的には とManual
同じです。
Type: | CollectionRefreshType |
Accepted values: | None, Manual, Periodic, Continuous, Both |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | 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でコレクションを作成する方法
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示