The Get-EntraBetaDevice cmdlet gets a device from Microsoft Entra ID. Specify the DeviceId parameter to get a specific device.
In delegated scenarios with work or school accounts, the signed-in user must have a supported Microsoft Entra role or a custom role with the required permissions. The following least privileged roles are supported:
Cloud Device Administrator
Intune Administrator
Windows 365 Administrator
Compliance Administrator
Device Managers
Parameters
-All
List all pages.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-DeviceId
Specifies the ID of a device in Microsoft Entra ID.
Parameter properties
Type:
System.String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
ObjectId
Parameter sets
GetById
Position:
Named
Mandatory:
True
Value from pipeline:
True
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Filter
Specifies the OData v4.0 filter statement.
This parameter controls which objects are returned.
Parameter properties
Type:
System.String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
GetQuery
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Property
Specifies properties to be returned
Parameter properties
Type:
System.String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Select
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-SearchString
Specifies a search string.
Parameter properties
Type:
System.String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
GetValue
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Top
Specifies the maximum number of records to return.
Parameter properties
Type:
System.Int32
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Limit
Parameter sets
GetQuery
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
True
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.