Get-CMCollectionMember
SYNOPSIS
Leden van een verzameling ophalen.
SYNTAX
ByCollectionName (standaard)
Get-CMCollectionMember -CollectionName <String> [-Name <String>] [-ResourceId <Int32>] [-SmsId <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ByCollectionId
Get-CMCollectionMember -CollectionId <String> [-Name <String>] [-ResourceId <Int32>] [-SmsId <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ByCollection
Get-CMCollectionMember -InputObject <IResultObject> [-Name <String>] [-ResourceId <Int32>] [-SmsId <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Met de cmdlet Get-CMCollectionMember worden leden van een Configuration Manager verzameling. Verzamelingen kunnen apparaten of gebruikers bevatten, maar niet beide. Wanneer u een query uitvoert op een verzameling, retourneert deze cmdlet objecten voor alle leden. U kunt de resultaten filteren op basis van de naam of id. Gebruik deze cmdlet om het bereik van een query voor apparaten of gebruikers te wijzigen in een specifieke verzameling.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een lid van een verzameling ophalen met behulp van de pijplijnoperator
Met deze opdracht wordt eerst de cmdlet Get-CMCollection gebruikt om het verzamelingsobject met de naam UserCol1 op te halen. Vervolgens wordt de pijplijnoperator gebruikt om het object door te geven aan Get-CMCollectionMember, waarmee alle leden in UserCol1 worden opgehaald. Ten slotte wordt in dit voorbeeld de cmdlet Select-Object gebruikt om alleen de ledennamen weer te geven.
Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name
Voorbeeld 2: Een lid van een verzameling ophalen op naam
Met deze opdracht wordt de verzameling DeviceCol1 opgevraagd voor leden met een naam die begint met domain . Het sterretje ( * ) komt overeen met meerdere tekens. Resultaten kunnen dus namen bevatten zoals 'domein1' of 'domeincontroller'.
Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"
Voorbeeld 3: Verzamelingsdetails exporteren naar een CSV
In dit voorbeeld wordt een query op de XYZ0004B-apparaatverzameling opgevraagd voor een set eigenschappen en op te slaat die in de variabele $collMem. De tweede regel converteert die gegevens naar een CSV-indeling (door komma's gescheiden waarden) en de uitvoer naar een bestand.
$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"
PARAMETERS
-CollectionId
Geef de id op van een verzameling die moet worden opgevraagd. Bijvoorbeeld "XYZ0004B".
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Geef de naam op van een verzameling die moet worden opgevraagd.
Type: String
Parameter Sets: ByCollectionName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een verzamelingsobject op om een query op uit te voeren. Gebruik een van de volgende cmdlets om een verzamelingsobject op te halen:
U kunt ook de pijplijnoperator ( ) gebruiken om een verzamelingsobject door te geven | aan Get-CMCollectionMemeber op de opdrachtregel.
Type: IResultObject
Parameter Sets: ByCollection
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Als u de resultaten wilt filteren, geeft u de naam van een resource in de verzameling op. Dit filter is niet casegevoelig.
U kunt jokertekens gebruiken:
*: Meerdere tekens?: Eén teken
Type: String
Parameter Sets: (All)
Aliases: ResourceName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-ResourceId
Als u de resultaten wilt filteren, geeft u een resource-id op. Bijvoorbeeld 16777242. De cmdlet retourneert alleen een record voor die resource in de doelverzameling.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SmsId
Als u de resultaten wilt filteren, geeft u de SMSID van een resource op. Bijvoorbeeld "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Dit filter is niet casegevoelig.
U kunt jokertekens gebruiken:
*: Meerdere tekens?: Eén teken
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.