Get-CMUserCollection

  • Referência
Módulo:
ConfigurationManager

Obtenha uma ou mais coleções de utilizadores.

Sintaxe

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

Utilize este cmdlet para obter uma ou mais coleções de utilizadores. Para obter coleções de dispositivos ou utilizadores, utilize o cmdlet Get-CMCollection . Para obter mais informações sobre coleçõ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 de utilizadores

Este comando obtém a coleção de utilizadores predefinida Todos os Utilizadores com ID SMS00002.

Get-CMUserCollection -CollectionId "SMS00002"

Parâmetros

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

-Id

Especifique o ID da coleção de utilizadores a obter. Este valor é a propriedade CollectionID , por exemplo, XYZ00013 ou SMS00002.

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 de utilizadores a obter.

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

Entradas

None

Saídas

System.Object

Observações

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