Compartilhar via

Get-CMDeviceCollection

  • Referência
Módulo:
ConfigurationManager

Obter uma ou mais coleções de dispositivos.

Syntax

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

Use este cmdlet para obter uma ou mais coleções de dispositivos. Para obter coleções de usuários ou dispositivos, use o cmdlet Get-CMCollection. Para obter mais informações sobre coleções, consulte Introdução a coleções no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Obter uma coleção de dispositivos usando uma ID

Este comando obtém a coleção de dispositivos padrão 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 ponto de distribuição chamado dpg1.

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

Quando você distribui conteúdo para essas coleções, o site distribui automaticamente a 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

-DistributionPointGroup

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

Type:IResultObject
Position:Named
Default value:None
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 rodeado por colchetes cacheados, por exemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352} .

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifique a ID do conjunto de dispositivos a ser obter. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 ou SMS00001 .

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

-Name

Especifique o nome da coleção de dispositivos a ser obter.

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

Entradas

Nenhum

Saídas

System.Object

Observações

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