New-CMDeviceCollection

Referência

Módulo:: ConfigurationManager

Criar uma coleção de dispositivos.

Syntax

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

Use este cmdlet para criar uma coleção de dispositivos com base em uma coleção de limitação específica. A coleção limitante determina quais dispositivos podem ser um membro da coleção de dispositivos que você cria. Por exemplo, quando você usa a coleção All Systems como coleção limitante, a nova coleção pode incluir qualquer dispositivo na hierarquia do Configuration Manager.

Em seguida, você pode adicionar dispositivos à coleção com regras de associação. Para adicionar membros à coleção de dispositivos, use um dos seguintes cmdlets de regra de associação:

Para obter mais informações, consulte Como criar coleções no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Criar uma coleção de dispositivos

Este comando cria uma coleção para todos os computadores que são executados Windows 11. O parâmetro LimitingCollectionName especifica que qualquer dispositivo na coleção All Systems pode ser membro da nova coleção.

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

Parâmetros

-Comentário

Especifique um comentário opcional para descrever e identificar essa coleção.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-InputObject

Especifique um objeto para a coleção de limitação. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMDeviceCollection.

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

-LimitingCollectionId

Especifique a ID da coleção de limitação. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 ou SMS00001 .

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

-LimitingCollectionName

Especifique o nome da coleção de limitação.

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

-Name

Especifique o nome da nova coleção de dispositivos.

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

-RefreshSchedule

Se você definir o parâmetro RefreshType como Periodic ou , use esse parâmetro para definir a Both agenda. Especifique um objeto schedule para quando o site executa uma atualização completa da associação de coleção. Para obter esse objeto, use o cmdlet New-CMSchedule.

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

-RefreshType

Especifique como a associação à coleção é atualizada:

Manual(1): um administrador dispara manualmente uma atualização de associação no console do Configuration Manager ou com o cmdlet Invoke-CMCollectionUpdate.
Periodic (2): o site faz uma atualização completa em um cronograma. Ele não usa atualizações incrementais. Se você não especificar um tipo, esse valor será o padrão.
Continuous (4): o site avalia periodicamente novos recursos e adiciona novos membros. Esse tipo também é conhecido como uma atualização incremental. Ele não faz uma atualização completa em um cronograma.
Both (6): uma combinação de atualizações incrementais e uma Periodic atualização completa em um Continuous cronograma.

Se você especificar ou Periodic , use o parâmetro Both RefreshSchedule para definir a agenda.

Observação

O None valor (0) é funcionalmente o mesmo que Manual .

Type:	CollectionRefreshType
Accepted values:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object