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.