Freigeben über

Get-CMCollection

  • Referenz
Modul:
ConfigurationManager

Abrufen eines Geräte- oder Benutzersammlungsobjekts.

Syntax

Get-CMCollection
   [-CollectionType <CollectionType>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Geräte- oder Benutzersammlungsobjekt abzurufen.

Sammlungen helfen Ihnen, Ressourcen in handhabbare Einheiten zu gliedern. Sie können Sammlungen erstellen, die Ihren Anforderungen an die Clientverwaltung entsprechen und Vorgänge für mehrere Ressourcen gleichzeitig ausführen. Die meisten Verwaltungsaufgaben basieren auf oder erfordern die Verwendung einer oder mehrerer Sammlungen.

Verwenden Sie die Cmdlets Get-CMDeviceCollection oder Get-CMUserCollection , um den Typ der abgerufenen Sammlung einzugrenzen.

Wenn Sie keine Sammlung nach Name, ID oder Objekt angeben, gibt dieses Cmdlet alle Sammlungen zurück.

Weitere Informationen finden Sie unter Einführung in Sammlungen in Configuration Manager.

Hinweis

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

Beispiele

Beispiel 1: Abrufen einer Sammlung anhand des Namens

Dieser Befehl ruft die Auflistung mit dem Namen testUser ab.

Get-CMCollection -Name "testUser"

Beispiel 2: Abrufen einer Sammlung für eine Verteilungspunktgruppe

Dieser Befehl ruft das Verteilungspunktgruppenobjekt mit dem Namen dpg1 ab und verwendet den Pipelineoperator, um das Objekt an Get-CMCollection zu übergeben, das die der Verteilungspunktgruppe zugeordneten Auflistungen abruft.

Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection

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

-CollectionType

Filtern Sie den Typ der abzurufenden Sammlung. Dieser Parameter ist funktional identisch mit der Verwendung der Cmdlets Get-CMDeviceCollection oder Get-CMUserCollection .

Typ:CollectionType
Zulässige Werte:User, Device
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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:True
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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die ID der abzurufenden Sammlung 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 Sammlung an.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject

Hinweise

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