Get-CMCollectionMember

  • Referenz
Modul:
ConfigurationManager

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 auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen eines Elements einer Auflistung mithilfe des Pipelineoperators

Dieser Befehl verwendet zunächst das Cmdlet Get-CMCollection , um das Sammlungsobjekt mit dem Namen UserCol1 abzurufen. Anschließend wird der Pipelineoperator verwendet, um das Objekt an Get-CMCollectionMember zu übergeben, der 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 Sammlung anhand des Namens

Dieser Befehl fragt die Sammlung DeviceCol1 nach Membern ab, deren Name mit domainbeginnt. Das Sternchen (*) entspricht mehreren Zeichen. Daher können die Ergebnisse Namen wie "domain1" oder "domain-controller" 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 abfragt und in der Variablen gespeichert, $collMem. In der zweiten Zeile werden diese Daten in das CSV-Format (Comma-Separated Value) 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 abzufragenden Sammlung an. Beispiel: "XYZ0004B".

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

-CollectionName

Geben Sie den Namen einer abzufragenden Sammlung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-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

-InputObject

Geben Sie ein abzufragende Auflistungsobjekt an. Verwenden Sie zum Abrufen eines Sammlungsobjekts eines der folgenden Cmdlets:

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

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

-Name

Um die Ergebnisse zu filtern, geben Sie den Namen einer Ressource in der Auflistung an. Bei diesem Filter wird die Groß-/Kleinschreibung nicht beachtet.

Sie können Ein-/Auslesezeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen
Typ:String
Aliase:ResourceName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-ResourceId

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

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

-SmsId

Um die Ergebnisse zu filtern, geben Sie die SMSID einer Ressource an. Beispiel: "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Bei diesem Filter wird die Groß-/Kleinschreibung nicht beachtet.

Sie können Ein-/Auslesezeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object