New-CMCollection

Referência

Módulo:: ConfigurationManager

Crie um dispositivo ou uma coleção de usuários.

Syntax

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionName <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -InputObject <IResultObject>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMCollection
   -CollectionType <CollectionType>
   [-Comment <String>]
   -LimitingCollectionId <String>
   -Name <String>
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para criar um dispositivo ou conjunto de usuários.

A coleção limitante determina quais recursos podem ser um membro da coleção que você cria. Por exemplo, quando você usa a coleção All Systems como coleção limitante, já que é uma coleção de dispositivos, a nova coleção de dispositivos pode incluir qualquer dispositivo na hierarquia do Configuration Manager.

Para escopo do tipo de coleção criado, você também pode usar os cmdlets New-CMDeviceCollection ou New-CMUserCollection.

Depois de criar uma coleção, adicione recursos à coleção com regras de associação. Para adicionar membros à coleção, use um dos cmdlets para adicionar regras de associação, por exemplo:

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 usuários

Este comando cria uma coleção de usuários chamada testUser que define a coleção All Users como a coleção limitante.

New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"

Exemplo 2: definir a coleção de limitação por meio do pipeline

Este comando primeiro usa Get-CMCollection para obter o objeto da coleção All Users. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet New-CMCollection, que cria uma coleção chamada testUser. A coleção limitante da nova coleção testUser é a coleção All Users.

Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"

Parâmetros

-CollectionType

Especifique o tipo de coleção a ser criado. Esse parâmetro é funcionalmente o mesmo que usar os cmdlets New-CMDeviceCollection ou New-CMUserCollection.

Type:	CollectionType
Accepted values:	User, Device
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
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, Get-CMDeviceCollectionou Get-CMUserCollection.

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
Aliases:	LimitToCollectionId
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
Aliases:	LimitToCollectionName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifique o nome da nova coleção.

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

-VariablePriority

Especifique um valor inteiro de 1 a 9 para a prioridade das variáveis de conjunto de dispositivos. 1 é a prioridade mais baixa e 9 é a mais alta.

Para criar variáveis em uma coleção de dispositivos, use o cmdlet New-CMDeviceCollectionVariable.

Type:	Int32
Aliases:	DeviceCollectionVariablePrecedence
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

IResultObject

Observações

Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_Collection classe WMI do servidor.