Share via

New-CMDeviceCollection

  • 参考
模块:
ConfigurationManager

创建设备集合。

语法

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>]

说明

使用此 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

指定用于描述和标识此集合的可选注释。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定限制集合的对象。 若要获取此对象，请使用 Get-CMCollection 或 Get-CMDeviceCollection cmdlet。

Type:IResultObject
Aliases:LimitingCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LimitingCollectionId

指定限制集合的 ID。 此值为 CollectionID 属性，例如 XYZ00012 或 SMS00001 。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LimitingCollectionName

指定限制集合的名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RefreshSchedule

如果将 RefreshType 参数设置为 Periodic 或 Both ，则使用此参数设置计划。 指定网站何时运行集合成员资格的完整更新的计划对象。 若要获取此对象，请使用 New-CMSchedule cmdlet。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RefreshType

指定如何更新集合成员身份：

  • Manual (1) ：管理员在 Configuration Manager 控制台或 Invoke-CMCollectionUpdate cmdlet 中手动触发成员身份更新。
  • 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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-名称

指定新设备集合的名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object