Compartilhar via


Get-CMDeviceCollection

Obtenha uma ou mais coleções de dispositivos.

Sintaxe

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

Description

Utilize este cmdlet para obter uma ou mais coleções de dispositivos. Para obter coleções de utilizadores ou dispositivos, 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 dispositivos com um ID

Este comando obtém a coleção de dispositivos predefinida Todos os Sistemas com ID SMS00001.

Get-CMDeviceCollection -CollectionId "SM00001"

Exemplo 2: Obter todas as coleções de dispositivos associadas a um grupo de pontos de distribuição

Este exemplo obtém todas as coleções de dispositivos associadas ao grupo de pontos de distribuição denominado dpg1.

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

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

-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 dispositivos 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 de dispositivos 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.