Freigeben über

Get-CMDevice

  • Referenz
Modul:
ConfigurationManager

Abrufen eines Configuration Manager-Geräts

Syntax

Get-CMDevice
   [-CollectionMember]
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   -Collection <IResultObject>
   [-CollectionMember]
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   -CollectionId <String>
   [-CollectionMember]
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   [-CollectionId <String>]
   [-CollectionMember]
   [-Fast]
   [-Resource]
   -ThreatId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   [-CollectionId <String>]
   [-CollectionMember]
   [-Fast]
   [-Resource]
   -ThreatName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   [-CollectionId <String>]
   [-CollectionMember]
   [-Fast]
   -InputObject <IResultObject>
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   [-CollectionMember]
   -CollectionName <String>
   [-Fast]
   [-Name <String>]
   [-Resource]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDevice
   [-CollectionMember]
   [-Fast]
   [-Resource]
   -ResourceId <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-CMDevice ruft ein Configuration Manager-Gerät ab. Standardmäßig wird die SMS_CM_RES_COLL_SMS00001-Klasse abfragt. Sie können die Parameter Resource oder CollectionMember verwenden, um die Abfrageklasse zu ändern. Abhängig von Ihrem rollenbasierten Zugriff auf der Website müssen Sie möglicherweise einen dieser anderen Parameter verwenden. Wenn Sie beispielsweise keinen Zugriff auf SMS00001 haben, gibt dieses Cmdlet standardmäßig null Ergebnisse zurück.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen von Geräten nach Sammlungs-ID

Dieser Befehl ruft alle Geräteobjekte in der Gerätesammlung mit der ID XYZ0004B ab. Es verwendet das Cmdlet Select-Object , um nur bestimmte Eigenschaften anzuzeigen.

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

Beispiel 2: Abrufen von Geräteressourcen nach Sammlungs-ID

Dieser Befehl ähnelt dem ersten Beispiel, verwendet jedoch den Parameter -Resource . Wenn eine andere Klasse abfragt, werden unterschiedliche Eigenschaften für ähnliche Daten zurückgegeben.

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}

Beispiel 3: Abrufen von Eigenschaften für ein bestimmtes Gerät

Dieser Befehl ruft ein bestimmtes Gerät ab und leitet die Ausgabe über das Cmdlet Select-Object weiter, um nur bestimmte Eigenschaften anzuzeigen. Da der Parameter -Resource verwendet wird, sind die Eigenschaften spezifisch für diese Klasse.

Get-CMDevice -Name "DEVICE-LT2" -Resource | Select-Object Name, CPUType, DistinguishedName, HardwareID, IPAddresses

Beispiel 4: Abrufen von Geräten, die keine Clients sind

Dieser Befehl verwendet den Parameter -Fast , um alle Geräte ohne verzögerte Eigenschaften abzurufen. Die Liste wird nur nach Geräten gefiltert, bei denen es sich nicht um Clients handelt. Es wird nur der Gerätename in der endgültigen Liste angezeigt.

Get-CMDevice -Fast | Where-Object { $_.IsClient -eq $false } | Select-Object Name

Beispiel 5: Abrufen von Geräten für einen bestimmten Bedrohungsnamen

Dieser Befehl zeigt alle Geräte an, auf denen Microsoft Defender eine bestimmte Bedrohung erkannt hat. Es wird nur der Name des Geräts angezeigt.

Get-CMDevice -ThreatName "Trojan:Win32/Wacatac.B!ml" | Select-Object Name

Beispiel 6: Abrufen aller Geräte mit erkannter Schadsoftware

Dieser Befehl verwendet zunächst das Cmdlet Get-CMDetectedMalware , um alle Bedrohungen abzurufen. Anschließend wird diese Liste analysiert und der Name der Geräte mit Schadsoftware angezeigt.

$allMalware = Get-CMDetectedMalware
foreach ( $malware in $allMalware ) { Get-CMDevice -InputObject $malware | Select-Object Name }

Parameter

-Collection

Verwenden Sie diesen Parameter, um alle Geräte aus einem Gerätesammlungsobjekt abzurufen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDeviceCollection .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionId

Geben Sie eine ID für eine Gerätesammlung an. Beispiel: XYZ0004B.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionMember

Fügen Sie diesen Parameter hinzu, um die Klassen SMS_R_UnknownSystem und SMS_R_System nach Geräteinformationen abzufragen. Diese Klassen können durch rollenbasierten Zugriff eingeschränkt werden. Diese Klassen enthalten ausführlichere Computerinformationen.

Typ:SwitchParameter
Aliase:CollectionMemberInstance
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionName

Geben Sie den Namen einer Gerätesammlung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein erkanntes Schadsoftwareobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDetectedMalware .

Typ:IResultObject
Aliase:Threat
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen eines Geräts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Resource

Fügen Sie diesen Parameter hinzu, um die SMS_Resource-Klasse nach Geräteinformationen abzufragen. Diese Klasse sollte nicht durch rollenbasierten Zugriff eingeschränkt werden. Die Ausgabe entspricht der Ausgabe des Cmdlets Get-CMResource . Diese Ausgabe weist minimale Eigenschaften für das Gerät auf. Fügen Sie für ausführlichere Eigenschaften diesen Parameter nicht hinzu, oder verwenden Sie den Parameter CollectionMember .

Typ:SwitchParameter
Aliase:ResourceInstance
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceId

Geben Sie die Ressourcen-ID eines Geräts an. Beispiel: 16780010.

Typ:Int32
Aliase:Id, DeviceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ThreatId

Verwenden Sie diesen Parameter, um die Geräte, die an die Geräte mit einer bestimmten Schadsoftware zurückgegeben werden, nach ID zu filtern. Beispiel: 2147735505. Verwenden Sie zum Abrufen dieser Bedrohungs-ID das Cmdlet Get-CMDetectedMalware .

Typ:String
Aliase:ThreatNameId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ThreatName

Verwenden Sie diesen Parameter, um die Geräte zu filtern, die an diese Geräte mit spezifischer Schadsoftware nach Namen zurückgegeben werden. Beispiel: Trojan:Win32/Wacatac.B!ml. Verwenden Sie zum Abrufen dieses Bedrohungsnamens das Cmdlet Get-CMDetectedMalware .

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_CombinedDeviceResources WMI-Serverklasse.