Get-CMCollectionMember
SYNOPSIS
Pobieranie elementów członkowskich kolekcji.
SYNTAX
ByCollectionName (ustawienie domyślne)
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
Polecenie cmdlet Get-CMCollectionMember pobiera elementy członkowskie Menedżer konfiguracji kolekcji. Kolekcje mogą obejmować urządzenia lub użytkowników, ale nie oba te urządzenia. Podczas wykonywania zapytania do kolekcji to polecenie cmdlet zwraca obiekty dla wszystkich elementów członkowskich. Wyniki można filtrować na podstawie nazwy lub identyfikatora. To polecenie cmdlet umożliwia zakres zapytania dla urządzeń lub użytkowników do określonej kolekcji.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: pobieranie członka kolekcji za pomocą operatora potoku
To polecenie najpierw używa polecenia cmdlet Get-CMCollection w celu uzyskania obiektu kolekcji o nazwie UserCol1. Następnie używa operatora potoku do przekazania obiektu do polecenia Get-CMCollectionMember, które pobiera wszystkie elementy członkowskie w usercol1. Na koniec w tym przykładzie użyto polecenia cmdlet Select-Object, aby wyświetlić tylko nazwy członków.
Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name
Przykład 2: pobieranie członka kolekcji według nazwy
To polecenie wysyła zapytanie do kolekcji DeviceCol1 dla elementów członkowskich o nazwie rozpoczynającej się od domain . Symbol wieloznaczny gwiazdki * () pasuje do wielu znaków. W związku z tym wyniki mogą zawierać nazwy takie jak "domena1" lub "kontroler domeny".
Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"
Przykład 3: Eksportowanie szczegółów kolekcji do pliku CSV
W tym przykładzie wysyłasz zapytanie do kolekcji urządzeń XYZ0004B o zestaw właściwości i przechowuje je w zmiennej $collMem. Drugi wiersz konwertuje te dane na format wartości rozdzielanych przecinkami (CSV), a dane wyjściowe na plik.
$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
Określ identyfikator kolekcji, dla których ma być zapytanie. Na przykład "XYZ0004B".
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName (Nazwa kolekcji)
Określ nazwę kolekcji, dla których ma być zapytanie.
Type: String
Parameter Sets: ByCollectionName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określ obiekt kolekcji do zapytania. Aby uzyskać obiekt kolekcji, użyj jednego z następujących polecenia cmdlet:
Można również użyć operatora potoku ( ), aby przekazać obiekt kolekcji do | polecenia Get-CMCollectionMemeber w wierszu polecenia.
Type: IResultObject
Parameter Sets: ByCollection
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Aby filtrować wyniki, określ nazwę zasobu w kolekcji. W tym filtrze nie jest wielkość liter.
Można używać symboli wieloznacznych:
*: wiele znaków?: pojedynczy znak
Type: String
Parameter Sets: (All)
Aliases: ResourceName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-ResourceId
Aby filtrować wyniki, określ identyfikator zasobu. Na przykład 16777242. Polecenie cmdlet zwraca tylko rekord dla tego zasobu w kolekcji docelowej.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SmsId
Aby filtrować wyniki, określ wartość SMSID zasobu. Na przykład "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". W tym filtrze nie jest wielkość liter.
Można używać symboli wieloznacznych:
*: wiele znaków?: pojedynczy znak
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.