Get-CMDeviceCollection

  • Referenz
Modul:
ConfigurationManager

Abrufen einer oder mehrerer Gerätesammlungen.

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Gerätesammlungen abzurufen. Verwenden Sie zum Abrufen von Benutzer- oder Gerätesammlungen das Cmdlet Get-CMCollection . Weitere Informationen zu Sammlungen finden Sie unter Einführung in Sammlungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen einer Gerätesammlung mithilfe einer ID

Dieser Befehl ruft die Standardgerätesammlung Alle Systeme mit id SMS00001 ab.

Get-CMDeviceCollection -CollectionId "SM00001"

Beispiel 2: Abrufen aller Gerätesammlungen, die einer Verteilungspunktgruppe zugeordnet sind

In diesem Beispiel werden alle Gerätesammlungen abgerufen, die der Verteilungspunktgruppe dpg1 zugeordnet sind.

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

Wenn Sie Inhalte an diese Sammlungen verteilen, wird die Website automatisch an alle aktuellen Mitglieder dieser Verteilungspunktgruppe verteilt. Weitere Informationen finden Sie unter Verwalten von Verteilungspunktgruppen.

Parameter

-DistributionPointGroup

Geben Sie ein Verteilungspunktgruppenobjekt an, das dieser Auflistung zugeordnet ist. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDistributionPointGroup .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DistributionPointGroupId

Geben Sie die GUID für eine Verteilungspunktgruppe an, die dieser Sammlung zugeordnet ist. Dieser Wert ist die GroupID-Eigenschaft , bei der es sich um eine Standard-GUID handelt, die von geschweiften Klammern umgeben ist, {537e6303-69eb-4104-bf7b-7baf43ce2352}z. B. .

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DistributionPointGroupName

Geben Sie den Namen einer Verteilungspunktgruppe an, die dieser Auflistung zugeordnet ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die ID der abzurufenden Gerätesammlung an. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012 . oder SMS00001.

Typ:String
Aliase:CollectionId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der abzurufenden Gerätesammlung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

None

Ausgaben

System.Object

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Collection WMI-Serverklasse.