< Back
Get-DUser
Post
NAME Get-DUser
SYNOPSIS
Gets one or multiple users from Delegate365.
SYNTAX
Get-DUser [-All <SwitchParameter>] [-Identity <string>] [-OU <string>] [-UnAssigned <SwitchParameter>]
[<CommonParameters>]
DESCRIPTION
Get-DUser returns a list of users from Delegate365. 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.
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.
PARAMETERS
-UnAssigned <SwitchParameter>
Delivers all users from Delegate365 that are not assigned to an OU. Requires the PowerShell Administration
permission.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-All <SwitchParameter>
Delivers all users (and not only the first 100 users).
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Identity <string>
Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-OU <string>
Filter by the name of an OU.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Delegate365.Api.Core.Models.User[]
---------- EXAMPLE 1 ----------
Get-DUser
By default, the command returns the first 100 assigned users.
---------- EXAMPLE 2 ----------
Get-DUser -All
Add -All to get all users.
---------- EXAMPLE 3 ----------
Get-DUser -Unassigned -All
Add -Unassigned to get users that are NOT assigned to an OU (can be combined with -All).
---------- EXAMPLE 4 ----------
Get-DUser -OU Seattle
Add -OU to get users that are assigned to a specific OU.
---------- EXAMPLE 5 ----------
Get-DUser -Identity john.doe@delegate365.com
Get one specific user by UPN or by ID.
RELATED LINKS
Delegate365 support https://support.delegate365.com/
SYNOPSIS
Gets one or multiple users from Delegate365.
SYNTAX
Get-DUser [-All <SwitchParameter>] [-Identity <string>] [-OU <string>] [-UnAssigned <SwitchParameter>]
[<CommonParameters>]
DESCRIPTION
Get-DUser returns a list of users from Delegate365. 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.
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.
PARAMETERS
-UnAssigned <SwitchParameter>
Delivers all users from Delegate365 that are not assigned to an OU. Requires the PowerShell Administration
permission.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-All <SwitchParameter>
Delivers all users (and not only the first 100 users).
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Identity <string>
Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-OU <string>
Filter by the name of an OU.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Delegate365.Api.Core.Models.User[]
---------- EXAMPLE 1 ----------
Get-DUser
By default, the command returns the first 100 assigned users.
---------- EXAMPLE 2 ----------
Get-DUser -All
Add -All to get all users.
---------- EXAMPLE 3 ----------
Get-DUser -Unassigned -All
Add -Unassigned to get users that are NOT assigned to an OU (can be combined with -All).
---------- EXAMPLE 4 ----------
Get-DUser -OU Seattle
Add -OU to get users that are assigned to a specific OU.
---------- EXAMPLE 5 ----------
Get-DUser -Identity john.doe@delegate365.com
Get one specific user by UPN or by ID.
RELATED LINKS
Delegate365 support https://support.delegate365.com/