Get-MsolDevice
Gets an individual device, or a list of devices.
Syntax
Get-MsolDevice
-Name <String>
[<CommonParameters>] Get-MsolDevice
[-All]
[-ReturnRegisteredOwners]
[<CommonParameters>] Get-MsolDevice
-DeviceId <Guid>
[<CommonParameters>] Get-MsolDevice
-All
-LogonTimeBefore <DateTime>
[<CommonParameters>] Get-MsolDevice
-ObjectId <Guid>
[<CommonParameters>] Get-MsolDevice
-RegisteredOwnerUpn <String>
[<CommonParameters>] Get-MsolDevice
-All
-IncludeSystemManagedDevices
[<CommonParameters>] Description
The Get-MsolDevice cmdlet gets an individual device, or a list of devices.
Examples
Example 1: Get a device object
PS C:\>Get-MsolDevice -Name "NIC0123"This command gets a device object that is named NIC0123.
Example 2: Get a list of device objects
PS C:\>Get-MsolDevice -AllThis command gets a list of device objects. Since the ReturnRegisteredOwners parameter is not used, the device object does not contain the registeredOwners property.
Example 3: Get a list of device objects that contains the registeredOwners property
PS C:\>Get-MsolDevice -All -ReturnRegisteredOwnersThis command gets a list of device objects. Since the ReturnRegisteredOwners parameter is used, the device object contains the registeredOwners property.
Example 4: Get a device by device ID
PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"This command gets a device with the corresponding device ID.
Example 5: Get a device object by object ID
PS C:\>Get-MsolDevice -ObjectId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"This command gets a device with the corresponding object ID.
Example 6: Get devices registered by UPN
PS C:\>Get-MsolDevice -RegisteredOwnerUpn "pattifuller@contoso.com"This command gets all the devices registered by the user with the UPN named pattifuller@contoso.com.
Example 7: Get device by activity (logon) timestamp
PS C:\>Get-MsolDevice -All -LogonTimeBefore 'January 1, 2017 12:00:00 AM'Ths command gets all the devices with the ApproximateLastLogonTimestamp before January 1, 2017
Example 8: Get devices and include system managed devices
PS C:\>Get-MsolDevice -All -IncludeSystemManagedDevicesThis command gets all devices and includes auto-pilot devices and other devices that are used with Intune (e.g. EAS)
Parameters
-All
Indicates that this cmdlet returns all results.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceId
Specifies the device ID of the device that this cmdlet gets.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IncludeSystemManagedDevices
Indicates that this cmdlet includes devices that are managed by the system such as auto-pilot.
| Type: | SwitchParamater |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogonTimeBefore
Specified the date (UTC) used to filter the device list by.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifies the display name of the device that this cmdlet gets.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ObjectId
Specifies the unique object ID of the device that this cmdlet gets.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RegisteredOwnerUpn
Specifies the user object that is the registered owner of the device. You need to provide the user principal name (UPN) or ObjectId, or pass an instance of a Microsoft.Online.Administration.User object that contains the user's UPN or ObjectId.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReturnRegisteredOwners
Indicates that this cmdlet returns the device's registeredOwners property.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Microsoft.Online.Administration.Device
This cmdlet returns device objects, which include the following information:
- AccountEnabled: The device's status: enabled or disabled.
- ObjectId: The device's unique ID.
- DeviceId: The device's device ID.
- DisplayName: The device's display name.
- DeviceObjectVersion: The device's object version number.
- DeviceOSType: The device operating system type.
- DeviceOSVersion: The device operating system version number.
- DeviceTrustType: The device trust type. The value could be one of the following: Workplace Joined, AzureAD Joined, Domain Joined.
- DeviceTrustLevel: The device trust level. The value could be one of the following: Authenticated, Compliant, Managed.
- DevicePhysicalIds: The device physical Ids.
- ApproximateLastLogonTimestamp: The last logon timestamp using this device.
- AlternativeSecurityIds: The device alternative security Ids.
- DirSyncEnabled: If the device is enabled with DirSync.
- LastDirSyncTime: The last timestamp the device was synchronized by DirSync.
- RegisteredOwners: The device's registered owner.
- GraphDeviceObject: The device object returned from graph API.