Condividi tramite


Get-CMDeviceCollection

Ottenere una o più raccolte di dispositivi.

Sintassi

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>]

Descrizione

Usare questo cmdlet per ottenere una o più raccolte di dispositivi. Per ottenere raccolte di utenti o dispositivi, usare il cmdlet Get-CMCollection . Per altre informazioni sulle raccolte, vedere Introduzione alle raccolte in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere una raccolta di dispositivi usando un ID

Questo comando ottiene la raccolta di dispositivi predefinita Tutti i sistemi con ID SMS00001.

Get-CMDeviceCollection -CollectionId "SM00001"

Esempio 2: Ottenere tutte le raccolte di dispositivi associate a un gruppo di punti di distribuzione

In questo esempio vengono recuperate tutte le raccolte di dispositivi associate al gruppo di punti di distribuzione denominato dpg1.

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

Quando si distribuisce contenuto a queste raccolte, il sito viene automaticamente distribuito a tutti i membri correnti di questo gruppo di punti di distribuzione. Per altre informazioni, vedere Gestire i gruppi di punti di distribuzione.

Parametri

-DistributionPointGroup

Specificare un oggetto gruppo di punti di distribuzione associato a questa raccolta. Per ottenere questo oggetto, usare il cmdlet Get-CMDistributionPointGroup .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointGroupId

Specificare il GUID per un gruppo di punti di distribuzione associato a questa raccolta. Questo valore è la proprietà GroupID , ovvero un GUID standard racchiuso tra parentesi graffe, {537e6303-69eb-4104-bf7b-7baf43ce2352}ad esempio .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointGroupName

Specificare il nome di un gruppo di punti di distribuzione associato a questa raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID della raccolta di dispositivi da ottenere. Questo valore è la proprietà CollectionID , ad esempio, XYZ00012 o SMS00001.

Tipo:String
Alias:CollectionId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome della raccolta di dispositivi da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

None

Output

System.Object

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Collection classe WMI del server.