Compartilhar via

New-CMDeviceCollection

  • Referência
Módulo:
ConfigurationManager

Criar uma coleção de dispositivos.

Sintaxe

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

Utilize este cmdlet para criar uma coleção de dispositivos com base numa coleção de limitação específica. A coleção de limitação determina que dispositivos podem ser membros da coleção de dispositivos que criar. Por exemplo, quando utiliza a coleção Todos os Sistemas como coleção de limitação, a nova coleção pode incluir qualquer dispositivo na hierarquia do Configuration Manager.

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

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

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Criar uma coleção de dispositivos

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

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

Parâmetros

-Comment

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:IResultObject
Aliases:LimitingCollection
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LimitingCollectionId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LimitingCollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RefreshSchedule

Se definir o parâmetro RefreshType como Periodic ou Both, utilize este parâmetro para definir a agenda. Especifique um objeto de agendamento para quando o site executar uma atualização completa da associação à coleção. Para obter este objeto, utilize o cmdlet New-CMSchedule .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RefreshType

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

  • Manual (1): Um administrador aciona manualmente uma atualização de associação na consola do Configuration Manager ou com o cmdlet Invoke-CMCollectionUpdate .
  • Periodic (2): O site efetua uma atualização completa com base numa agenda. Não utiliza atualizações incrementais. Se não especificar um tipo, este valor é a predefinição.
  • Continuous (4): O site avalia periodicamente novos recursos e, em seguida, adiciona novos membros. Este tipo também é conhecido como uma atualização incremental. Não efetua uma atualização completa com base numa agenda.
  • Both (6): uma combinação de e PeriodicContinuous, com atualizações incrementais e uma atualização completa com base numa agenda.

Se especificar ou PeriodicBoth, utilize o parâmetro RefreshSchedule para definir a agenda.

Observação

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

Tipo:CollectionRefreshType
Valores aceitos:None, Manual, Periodic, Continuous, Both
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object