Get-CMDevice
SYNOPSIS
Pobierz urządzenie Menedżer konfiguracji urządzenie.
SYNTAX
ByName (wartość domyślna)
Get-CMDevice [-CollectionMember] [-Fast] [-Name <String>] [-Resource] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
SearchByValueMandatory
Get-CMDevice -Collection <IResultObject> [-CollectionMember] [-Fast] [-Name <String>] [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByIdMandatory
Get-CMDevice -CollectionId <String> [-CollectionMember] [-Fast] [-Name <String>] [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByIdMandatoryForViewInfectedClients
Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] [-Resource] -ThreatId <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByNameMandatoryForViewInfectedClients
Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] [-Resource] -ThreatName <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByValueMandatoryForViewInfectedClients
Get-CMDevice [-CollectionId <String>] [-CollectionMember] [-Fast] -InputObject <IResultObject> [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchByNameMandatory
Get-CMDevice [-CollectionMember] -CollectionName <String> [-Fast] [-Name <String>] [-Resource]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
ById
Get-CMDevice [-CollectionMember] [-Fast] [-Resource] -ResourceId <Int32> [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Polecenie cmdlet Get-CMDevice pobiera Menedżer konfiguracji urządzenia. Domyślnie wysyła zapytanie do SMS_CM_RES_COLL_SMS00001 klasy . Możesz użyć parametrów -Resource lub -CollectionMember, aby zmienić klasę zapytania. W zależności od dostępu opartego na rolach w witrynie może być konieczne użycie jednego z tych innych parametrów.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Pobieranie urządzeń według identyfikatora kolekcji
To polecenie pobiera wszystkie obiekty urządzeń w kolekcji urządzeń o identyfikatorze XYZ0004B. Używa on polecenia cmdlet Select-Object, aby wyświetlić tylko określone właściwości.
Get-CMDevice -CollectionID "XYZ0004B" | Select-Object Name, ClientVersion, DeviceOS, IsActive, LastActiveTime, LastClientCheckTime, LastDDR, LastHardwareScan, LastPolicyRequest
Name : DEVICE-LT3
ClientVersion : 5.00.9012.1020
DeviceOS : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
IsActive : True
LastActiveTime : 10/1/2020 23:29:34
LastClientCheckTime : 9/8/2020 18:38:10
LastDDR : 9/30/2020 20:29:33
LastHardwareScan : 9/30/2020 22:24:22
LastPolicyRequest : 10/1/2020 23:29:34
Name : DEVICE-LT2
ClientVersion : 5.00.9030.1011
DeviceOS : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
IsActive : True
LastActiveTime : 10/2/2020 00:31:54
LastClientCheckTime : 9/30/2020 23:06:10
LastDDR : 9/30/2020 19:44:46
LastHardwareScan : 9/30/2020 01:15:52
LastPolicyRequest : 10/2/2020 00:31:54
Przykład 2: Pobieranie zasobów urządzenia według identyfikatora kolekcji
To polecenie jest podobne do pierwszego przykładu, ale używa parametru -Resource. Gdy wysyła zapytanie do innej klasy, zwraca różne właściwości dla podobnych danych.
Get-CMDevice -CollectionID "XYZ0004B" -Resource | Select-Object Name, ClientVersion, OperatingSystemNameandVersion, Active, AgentName, AgentTime
Name : DEVICE-LT3
ClientVersion : 5.00.9012.1020
OperatingSystemNameandVersion : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
Active : 1
AgentName : {SMS_AD_SYSTEM_DISCOVERY_AGENT, SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT,
MP_ClientRegistration, Heartbeat Discovery}
AgentTime : {2/28/2020 09:45:01, 10/2/2020 01:00:01, 9/21/2020 15:53:47, 9/30/2020 13:29:33}
Name : DEVICE-LT2
ClientVersion : 5.00.9030.1011
OperatingSystemNameandVersion : Microsoft Windows NT Workstation 10.0 (Tablet Edition)
Active : 1
AgentName : {SMS_AD_SYSTEM_DISCOVERY_AGENT, SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT,
MP_ClientRegistration, Heartbeat Discovery}
AgentTime : {2/28/2020 09:45:01, 10/2/2020 01:00:01, 10/1/2020 14:03:56, 9/30/2020 12:44:46}
Przykład 3: Uzyskiwanie właściwości dla określonego urządzenia
To polecenie pobiera określone urządzenie i potokuje dane wyjściowe za pośrednictwem polecenia cmdlet Select-Object, aby wyświetlić tylko określone właściwości. Ponieważ używa parametru -Resource, właściwości są specyficzne dla tej klasy.
Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses
Przykład 4: Uzyskiwanie urządzeń, które nie są klientami
To polecenie używa parametru -Fast, aby pobrać wszystkie urządzenia bez właściwości z opóźnieniem. Filtruje listę tylko do urządzeń, które nie są klientami. Nazwa urządzenia jest wyświetlana tylko na końcowej liście.
Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name
Przykład 5. Uzyskiwanie urządzeń dla określonej nazwy zagrożenia
To polecenie pokazuje wszystkie urządzenia, na których usługa Microsoft Defender wykryła określone zagrożenie. Wyświetla tylko nazwę urządzenia.
Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name
Przykład 6: Pobierz wszystkie urządzenia z wykrytym złośliwym oprogramowaniem
To polecenie najpierw używa polecenia cmdlet Get-CMDetectedMalware w celu uzyskania wszystkich zagrożeń. Następnie analizuje listę i wyświetla nazwę urządzeń ze złośliwym oprogramowaniem.
$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }
PARAMETERS
-Collection (Kolekcja)
Użyj tego parametru, aby pobrać wszystkie urządzenia z obiektu kolekcji urządzeń. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMDeviceCollection.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Określ identyfikator kolekcji urządzeń. Na przykład XYZ0004B.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients, SearchByNameMandatoryForViewInfectedClients, SearchByValueMandatoryForViewInfectedClients
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionMember
Dodaj ten parametr, aby odpytować klasy SMS_R_UnknownSystem i SMS_R_System o informacje o urządzeniu. Te klasy mogą być ograniczone przez dostęp oparty na rolach. Te klasy zawierają bardziej szczegółowe informacje o maszynie.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CollectionMemberInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Określ nazwę kolekcji urządzeń.
Type: String
Parameter Sets: SearchByNameMandatory
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 znaków literału. 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
-Fast
Dodaj ten parametr, aby nie odświeżać automatycznie właściwości z opóźnieniem. Właściwości z opóźnieniem zawierają wartości, które są stosunkowo niewydajne do pobrania. Uzyskanie tych właściwości może spowodować dodatkowy ruch sieciowy i zmniejszyć wydajność polecenia cmdlet.
Jeśli nie używasz tego parametru, polecenie cmdlet wyświetli ostrzeżenie. Aby wyłączyć to ostrzeżenie, ustaw wartość $CMPSSuppressFastNotUsedCheck = $true .
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 wykryty obiekt złośliwego oprogramowania. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMDetectedMalware.
Type: IResultObject
Parameter Sets: SearchByValueMandatoryForViewInfectedClients
Aliases: Threat
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Określ nazwę urządzenia.
Type: String
Parameter Sets: ByName, SearchByValueMandatory, SearchByIdMandatory, SearchByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Resource (Zasób)
Dodaj ten parametr, aby odpytować klasę SMS_Resource o informacje o urządzeniu. Ta klasa nie powinna być ograniczona przez dostęp oparty na rolach. Dane wyjściowe są takie same jak w przypadku polecenia cmdlet Get-CMResource. Te dane wyjściowe mają minimalne właściwości dla urządzenia. Aby uzyskać bardziej szczegółowe właściwości, nie dodawaj tego parametru ani nie używaj parametru -CollectionMember.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ResourceInstance
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResourceId
Określ identyfikator zasobu urządzenia. Na przykład 16780010.
Type: Int32
Parameter Sets: ById
Aliases: Id, DeviceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThreatId
Użyj tego parametru, aby filtrować urządzenia zwracane do urządzeń z określonym złośliwym oprogramowaniem według identyfikatora. Na przykład 2147735505. Aby uzyskać ten identyfikator zagrożenia, użyj polecenia cmdlet Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByIdMandatoryForViewInfectedClients
Aliases: ThreatNameId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThreatName
Użyj tego parametru, aby filtrować urządzenia zwracane do urządzeń z określonym złośliwym oprogramowaniem według nazwy. Na przykład Trojan:Win32/Wacatac.B!ml. Aby uzyskać tę nazwę zagrożenia, użyj polecenia cmdlet Get-CMDetectedMalware.
Type: String
Parameter Sets: SearchByNameMandatoryForViewInfectedClients
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
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.