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 .

Type:CollectionType
Accepted values:User, Device
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroup

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

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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. .

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

-DistributionPointGroupName

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

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

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

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

-Name

Geben Sie den Namen der abzurufenden Sammlung an.

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