共用方式為


New-CMDeviceCollection

建立裝置集合。

語法

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

Description

使用此 Cmdlet,根據特定限制集合建立裝置集合。 限制集合會決定哪些裝置可以是您所建立之裝置集合的成員。 例如,當您使用 All Systems 集合做為限制集合時,新的集合可以在 Configuration Manager 階層中包含任何裝置。

然後,您可以使用成員資格規則將裝置新增至集合。 若要將成員新增至裝置集合,請使用下列其中一個成員資格規則 Cmdlet:

如需詳細資訊,請 參閱如何在 Configuration Manager 中建立集合

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:建立裝置集合

此命令會為所有執行 Windows 11 的電腦建立集合。 LimitingCollectionName 參數會指定 All Systems 集合中的任何裝置都可以是新集合的成員。

New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"

參數

-Comment

指定選擇性批注來描述及識別此集合。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

指定限制集合的物件。 若要取得此物件,請使用 Get-CMCollectionGet-CMDeviceCollection Cmdlet。

類型:IResultObject
別名:LimitingCollection
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-LimitingCollectionId

指定限制集合的識別碼。 這個值是 CollectionID 屬性,例如 或 XYZ00012SMS00001

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-LimitingCollectionName

指定限制集合的名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Name

指定新裝置集合的名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-RefreshSchedule

如果您將 RefreshType 參數設定為 PeriodicBoth,請使用此參數來設定排程。 指定當網站執行集合成員資格的完整更新時的排程物件。 若要取得此物件,請使用 New-CMSchedule Cmdlet。

類型:IResultObject
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RefreshType

指定集合成員資格的更新方式:

  • Manual (1) :系統管理員在 Configuration Manager 控制台或 使用 Invoke-CMCollectionUpdate Cmdlet 手動觸發成員資格更新。
  • Periodic (2) :網站會依排程執行完整更新。 它不會使用累加式更新。 如果您未指定類型,則此值為預設值。
  • Continuous (4) :網站會定期評估新的資源,然後新增成員。 此類型也稱為 累加式更新。 它不會依排程執行完整更新。
  • Both (6) :和 的PeriodicContinuous組合,同時包含累加式更新和排程上的完整更新。

如果您指定 PeriodicBoth,請使用 RefreshSchedule 參數來設定排程。

注意事項

None (0) 的值在功能上與 Manual相同。

類型:CollectionRefreshType
接受的值:None, Manual, Periodic, Continuous, Both
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object