Get-AzureADDevice

  • Referenz
Modul:
AzureAD

Ruft ein Gerät aus Active Directory ab.

Syntax

Get-AzureADDevice
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADDevice
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADDevice
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzureADDevice ruft ein Gerät aus Azure Active Directory (AD) ab.

Beispiele

Beispiel 1: Abrufen eines Geräts nach ID

PS C:\>Get-AzureADDevice -ObjectId "3cb87a8f-0a41-4ca8-8910-e56cc00114a3"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c bastias_WindowsPhone_5/1/2016_12:53 PM

Dieser Befehl ruft das angegebene Gerät ab.

Beispiel 2: Abrufen aller Geräte

PS C:\>Get-AzureADDevice

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c bastias_WindowsPhone_5/1/2016_12:53 PM
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 New Device
d4fe7726-5966-431c-b3b8-cddc8fdb717d 293872f6-c006-4e6a-8629-07847c5ab078 New Device

Mit diesem Befehl werden alle verfügbaren Geräte abgerufen.

Beispiel 3: Abrufen von Geräten mithilfe eines Filterkriteriums

PS C:\>Get-AzureADDevice -Filter "startswith(DeviceOSType,'Windows')"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
3cb87a8f-0a41-4ca8-8910-e56cc00114a3 48445467-033c-42ca-8e38-8d181db1d49c DESKTOP-ABC123YN
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 DESKTOP-DJF4463Y
d4fe7726-5966-431c-b3b8-cddc8fdb717d 293872f6-c006-4e6a-8629-07847c5ab078 DESKTOP-HXB4327H

Beispiel 4: Abrufen eines bestimmten Geräts anhand des Namens

PS C:\>Get-AzureADDevice -SearchString "DESKTOP-DJF4463Y"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
62aae804-8b1a-4ab7-8fda-5068aed1a1f7 3cb87a8f-0a41-4ca8-8910-e56cc00114a3 DESKTOP-DJF4463Y

Parameter

-All

Wenn true, geben Sie alle Geräte zurück. Gibt bei false die Anzahl von Objekten zurück, die durch den Top-Parameter angegeben wird.

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

-Filter

Gibt die oData v3.0-Filteranweisungen an. Dieser Parameter steuert, welche Objekte zurückgegeben werden.

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

-ObjectId

Gibt die ID eines Geräts in Azure AD an.

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

-SearchString

Gibt eine Suchzeichenfolge an.

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

-Top

Gibt die maximale Anzahl von Datensätzen an, die zurückgegeben werden sollen.

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

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für Get-AzureADDevice zu Microsoft Graph PowerShell.