Get-CMCollectionMember
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.
Sie können Platzhalterzeichen verwenden:
*
: Mehrere Zeichen?
: Einzelnes Zeichen
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object