Share via

Get-CMCollection

  • Referência
Módulo:
ConfigurationManager

Obtenha um dispositivo ou objeto de coleção de usuários.

Syntax

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

Use este cmdlet para obter um dispositivo ou objeto de coleção de usuários.

As coleções ajudam a organizar recursos em unidades gerenciáveis. Você pode criar coleções para atender às suas necessidades de gerenciamento de cliente e executar operações em vários recursos ao mesmo tempo. A maioria das tarefas de gerenciamento depende ou requer o uso de uma ou mais coleções.

Para escopo do tipo de coleção que você obtém, use os cmdlets Get-CMDeviceCollection ou Get-CMUserCollection .

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

Para obter mais informações, consulte Introdução a coleções em Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Obter uma coleção pelo nome

Esse comando obtém a coleção chamada testUser.

Get-CMCollection -Name "testUser"

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

Esse comando obtém o objeto de grupo de pontos de distribuição chamado dpg1 e usa o operador de pipeline para passar 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 você distribui conteúdo para essas coleções, o site distribui automaticamente para todos os membros atuais desse grupo de pontos de distribuição. Para obter mais informações, consulte Gerenciar grupos de pontos de distribuição.

Parâmetros

-CollectionType

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

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-DistributionPointGroup

Especifique um objeto de grupo de pontos de distribuição associado a essa coleção. Para obter esse objeto, use o cmdlet Get-CMDistributionPointGroup .

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

-DistributionPointGroupId

Especifique o GUID para um grupo de pontos de distribuição associado a essa coleção. Esse valor é a propriedade GroupID , que é um GUID padrão cercado por colchetes encaracolados, por exemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352}.

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

-DistributionPointGroupName

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

Type:String
Position:Named
Default value:None
Required:True
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). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

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

Type:String
Aliases:CollectionId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome da coleção a ser obtido.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

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