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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_CombinedDeviceResources

IResultObject#SMS_CombinedDeviceResources

UWAGI

Get-CMResource

Approve-CMDevice

Block-CMDevice

Get-CMDeviceCollection

Remove-CMDevice

Unblock-CMDevice

Last updated on 2021-08-12

Udostępnij przez