Get-CMCollectionMember

Referenz

Modul:: ConfigurationManager

Dient zum Abrufen von Mitgliedern eines Geräts oder einer Benutzersammlung.

Syntax

Get-CMCollectionMember
   -CollectionName <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMCollectionMember
   -CollectionId <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMCollectionMember
   -InputObject <IResultObject>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um Mitglieder einer Sammlung abzurufen. Sammlungen können Geräte oder Benutzer enthalten, aber nicht beide. Wenn Sie eine Auflistung abfragen, gibt dieses Cmdlet Objekte für alle Elemente zurück.

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

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Abrufen eines Elements einer Auflistung mithilfe des Pipelineoperators

Dieser Befehl verwendet zuerst das Cmdlet "Get-CMCollection", um das Sammlungsobjekt mit dem Namen "UserCol1" abzurufen. Anschließend wird der Pipelineoperator verwendet, um das Objekt an Get-CMCollectionMemberzu übergeben, das alle Elemente in der Auflistung abruft. Schließlich wird in diesem Beispiel das Cmdlet "Select-Object" verwendet, um nur die Membernamen anzuzeigen.

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

Beispiel 2: Abrufen eines Elements einer Auflistung anhand des Namens

Dieser Befehl fragt die Sammlung DeviceCol1 nach Elementen ab, deren Name mit domain . Das Sternchen ( * ) entspricht mehreren Zeichen. Ergebnisse können namen wie "domäne1" oder "Domänencontroller" enthalten.

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

Beispiel 3: Exportieren von Sammlungsdetails in eine CSV-Datei

In diesem Beispiel wird die XYZ0004B-Gerätesammlung nach einer Reihe von Eigenschaften abgefragt und in der Variablen gespeichert, $collMem. In der zweiten Zeile werden diese Daten in das CSV-Format (Kommastrennte Werte) konvertiert und in eine Datei ausgegeben.

$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"

Parameter

-CollectionId

Geben Sie die ID einer Abfragesammlung an. Beispiel: "XYZ0004B".

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

-CollectionName

Geben Sie den Namen einer Abfragesammlung an.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

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

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

-InputObject

Geben Sie ein Abfragobjekt an. Um ein Sammlungsobjekt abzurufen, verwenden Sie eines der folgenden Cmdlets:

Sie können auch den Pipelineoperator ( | ) verwenden, um ein Auflistungsobjekt an Get-CMCollectionMemeber in der Befehlszeile zu übergeben.

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Geben Sie zum Filtern der Ergebnisse den Namen einer Ressource in der Auflistung an. Bei diesem Filter wird die Groß-/Kleinschreibung nicht beachtet.

Sie können Platzhalterzeichen verwenden:

*: Mehrere Zeichen
?: Einzelnes Zeichen

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

-ResourceId

Geben Sie zum Filtern der Ergebnisse eine Ressourcen-ID an. Beispiel: 16777242. Das Cmdlet gibt nur einen Datensatz für diese Ressource in der Zielsammlung zurück.

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

-SmsId

Geben Sie zum Filtern der Ergebnisse die SMSID einer Ressource an. Beispiel: "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Bei diesem Filter wird die Groß-/Kleinschreibung nicht beachtet.