New-CMCollection

  • Referência
Módulo:
ConfigurationManager

Crie uma coleção de dispositivos ou utilizadores.

Sintaxe

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

Utilize este cmdlet para criar uma coleção de dispositivos ou utilizadores.

A coleção de limitação determina que recursos podem ser membros da coleção que criar. Por exemplo, quando utiliza a coleção Todos os Sistemas como coleção de limitação, uma vez que é uma coleção de dispositivos, a nova coleção de dispositivos pode incluir qualquer dispositivo na hierarquia do Configuration Manager.

Para definir o âmbito do tipo de coleção que criar, também pode utilizar 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, utilize um dos cmdlets para adicionar regras de associação, por exemplo:

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 utilizadores

Este comando cria uma coleção de utilizadores com o nome testUser que define a coleção Todos os Utilizadores como a coleção de limitação.

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

Exemplo 2: Definir a coleção de limitação através do pipeline

Este comando utiliza primeiro Get-CMCollection para obter o objeto de coleção Todos os Utilizadores . Em seguida, utiliza o operador de pipeline para passar o objeto para o cmdlet New-CMCollection , que cria uma coleção com o nome testUser. A coleção de limitação da nova coleção testUser é a coleção Todos os Utilizadores .

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

Parâmetros

-CollectionType

Especifique o tipo de coleção a criar. Este parâmetro é funcionalmente o mesmo que utilizar os cmdlets New-CMDeviceCollection ou New-CMUserCollection .

Tipo:CollectionType
Valores aceitos:User, Device
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
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, Get-CMDeviceCollection ou Get-CMUserCollection .

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
Aliases:LimitToCollectionId
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
Aliases:LimitToCollectionName
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.

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

-VariablePriority

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

Para criar variáveis numa coleção de dispositivos, utilize o cmdlet New-CMDeviceCollectionVariable .

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

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_Collection classe WMI de servidor.