Get-CMDevice

Referenz

Modul:: ConfigurationManager

Rufen Sie ein Configuration Manager Gerät ab.

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 .

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Aliases:	CollectionMemberInstance
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Geben Sie den Namen einer Gerätesammlung an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	Threat
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Geben Sie den Namen eines Geräts an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	SwitchParameter
Aliases:	ResourceInstance
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

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

Type:	Int32
Aliases:	Id, DeviceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	String
Aliases:	ThreatNameId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Get-CMDevice

Syntax

Beschreibung

Beispiele

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

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

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

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

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

Beispiel 6: Abrufen aller Geräte mit erkannter Schadsoftware

Parameter

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Eingaben

Ausgaben

Hinweise

Feedback

Zusätzliche Ressourcen

Get-CMDevice

Syntax

Beschreibung

Beispiele

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

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

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

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

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

Beispiel 6: Abrufen aller Geräte mit erkannter Schadsoftware

Parameter

-Collection

-CollectionId

-CollectionMember

-CollectionName

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-InputObject

-Name

-Resource

-ResourceId

-ThreatId

-ThreatName

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Feedback

Zusätzliche Ressourcen