Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
79 lines (64 sloc) 3.08 KB

Get-DUser

Synopsis

Gets one or multiple users from Delegate365.

Description

Get-DUser returns a list of users or a specific user from Delegate365.

Important: By default, the command shows all users that are assigned to any OU in Delegate365. When using the -Unassigned parameter, all users are returned that are not assigned to an OU. Be aware that this parameter only delivers the unassigned users if the authenticated user is PowerShell Administrator. Scope Admins that are not PowerShell Administrator will see no output (an empty list), while PowerShell Administrators get all the unassigned users.

In Delegate365, users can be managed by Scope Admins if they are assigned to an OU. Parameters allow to get all users, users of a specific OU, or unassigned users. By default, the first 100 users are returned. Use the -All parameter to get the full list of users. Filter for one user by using the -Identity Parameter and the full UserPrincipalName or the ObjectID. The ouput delivers the most essential user properties: the Id in the Delegate365 database, the Identity is the AAD ObjectID, the UserPrincipalName, the DisplayName and the OU assignment.

Example

Get-DUser | ft

By default, the command returns the first 100 assigned users.

Output

WARNING: Result is limited to 100 items. Use the -All parameter to get all users.

Id Identity UserPrincipalName DisplayName OrganizationalUnit
1 8f5e906f-7f5d-46e2-bfd8-3b0cf4368861 AdamW@M365x737430.onmicrosoft.com Adam Wallen Seattle
2 d46974ab-bede-408c-bf59-6dccc9a65722 AdeleV@M365x737430.onmicrosoft.com Adele Vance Seattle
3 e080876a-31c0-47c8-9d96-a96c6f140ff3 AlexW@M365x737430.onmicrosoft.com Alex Wilber Seattle

Example

Get-DUser -All

Add -All to get all users.

Example

Get-DUser -Unassigned -All

Add -Unassigned to get users that are NOT assigned to an OU (can be combined with -All). Requires the PowerShell Administration permission.

Example

Get-DUser -OU 'New York'

Add -OU to get users that are assigned to a specific OU. There can only be one OU name used.

Example

Get-DUser -Identity john.doe@delegate365.com

Get one specific user by UPN or by ID.

Parameter Description

Parameter -Unassigned

Delivers all users from Delegate365 that are not assigned to an OU. The PowerShell Administration permission is required for delivering an output.

Parameter -All

Delivers all users (and not only the first 100 users).

Parameter -Identity

Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.

Parameter -OU

Filter by the name of an OU.

Output

The Output delivers the the most relevant user properties:

Id                 : 20
Identity           : f1234567-e321-d234-c678-b11234567890
UserPrincipalName  : john.doe@delegate365.com
DisplayName        : John Doe
OrganizationalUnit : Seattle

Back to the overview.