Compartilhar via

Get-CMUserCollection

  • Referência
Módulo:
ConfigurationManager

Obtenha uma ou mais coleções de usuários.

Syntax

Get-CMUserCollection
   [-Name <String>]
   [<CommonParameters>]
Get-CMUserCollection
   -Id <String>
   [<CommonParameters>]
Get-CMUserCollection
   -DistributionPointGroupName <String>
   [<CommonParameters>]
Get-CMUserCollection
   -DistributionPointGroupId <String>
   [<CommonParameters>]
Get-CMUserCollection
   -DistributionPointGroup <IResultObject>
   [<CommonParameters>]

Description

Use este cmdlet para obter uma ou mais coleções de usuários. Para obter coleções de dispositivos ou usuários, use o cmdlet Get-CMCollection . Para obter mais informações sobre coleções, consulte Introdução às 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 de usuários

Esse comando obtém a coleção de usuários padrão Todos os Usuários com ID SMS00002.

Get-CMUserCollection -CollectionId "SMS00002"

Parâmetros

-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:False
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

-Id

Especifique a ID da coleção de usuários a ser obtido. Esse valor é a propriedade CollectionID , por exemplo, XYZ00013 ou SMS00002.

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 de usuários a ser obtido.

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

Entradas

None

Saídas

System.Object

Observações

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