Get-CMCollection

  • Referência
Módulo:
ConfigurationManager

Obter um objeto de coleção de dispositivos ou utilizadores.

Sintaxe

Get-CMCollection
   [-CollectionType <CollectionType>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter um objeto de coleção de dispositivos ou utilizadores.

As coleções ajudam a organizar recursos em unidades gerenciáveis. Pode criar coleções para corresponder às suas necessidades de gestão de clientes e para realizar operações em vários recursos de uma só vez. A maioria das tarefas de gestão depende ou requer a utilização de uma ou mais coleções.

Para definir o âmbito do tipo de coleção que obtém, utilize os cmdlets Get-CMDeviceCollection ou Get-CMUserCollection .

Se não especificar uma coleção por nome, ID ou objeto, este cmdlet devolve todas as coleções.

Para obter mais informações, veja Introdução às 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: Obter uma coleção pelo nome

Este comando obtém a coleção com o nome testUser.

Get-CMCollection -Name "testUser"

Exemplo 2: Obter uma coleção para um grupo de pontos de distribuição

Este comando obtém o objeto do grupo de pontos de distribuição com o nome dpg1 e utiliza o operador de pipeline para transmitir o objeto para Get-CMCollection, que obtém as coleções associadas ao grupo de pontos de distribuição.

Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection

Quando distribui conteúdo para estas coleções, o site é distribuído automaticamente por todos os membros atuais deste grupo de pontos de distribuição. Para obter mais informações, veja Gerir grupos de pontos de distribuição.

Parâmetros

-CollectionType

Filtre o tipo de coleção a obter. Este parâmetro é funcionalmente o mesmo que utilizar os cmdlets Get-CMDeviceCollection ou Get-CMUserCollection .

Tipo:CollectionType
Valores aceitos:User, Device
Cargo:Named
Valor padrão:None
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

-DistributionPointGroup

Especifique um objeto de grupo de ponto de distribuição associado a esta coleção. Para obter este objeto, utilize o cmdlet Get-CMDistributionPointGroup .

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

-DistributionPointGroupId

Especifique o GUID de um grupo de pontos de distribuição associado a esta coleção. Este valor é a propriedade GroupID , que é um GUID padrão entre parênteses retos, por exemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352}.

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

-DistributionPointGroupName

Especifique o nome de um grupo de pontos de distribuição associado a esta coleção.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-Id

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

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

-Name

Especifique o nome da coleção a obter.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

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