< Back
New-DAdministrator
Post
NAME New-DAdministrator
SYNOPSIS
Creates a new administrator in Delegate365.
SYNTAX
New-DAdministrator [-UserPrincipalName] <string> [[-OrganizationalUnits] <string[]>] [[-Domains] <string[]>]
[[-Settings] <AdministratorSettings>] [[-D365Permission] <string>] [<CommonParameters>]
DESCRIPTION
New-DAdministrator creates a new administrator in Delegate365. To use Delegate365, a user must be added as
Administrator in the Administrator's list. Permissions and assignments to OU's and to domains define the scope for
an administrator. Administrators can be users in the same Office 365 tenant, or can be external users with an
Office 365 work account. Optional, additional properties can be handed over to the command, see the example. The
output shows the created admin object.
PARAMETERS
-UserPrincipalName <string>
UserPrincipalName is the login name of the new admin and is required.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-OrganizationalUnits <string[]>
OrganizationalUnits can be a string array, that can be separated by comma, e.g. 'Paris', 'New York'.
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Domains <string[]>
Domains can be a string array, that can be separated by comma, e.g. 'atwork-it.com', 'delegate365.com'.
Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Settings <AdministratorSettings>
Settings allow to set the notification email, phone number and other settings for the admin.
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-D365Permission <string>
D365Permission define the name of the permission policy that shall be assigned.
Required? false
Position? 6
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.Administrator
---------- EXAMPLE 1 ----------
New-DAdministrator -UserPrincipalName 'john.doe@delegate365.com'
For creating a new admin, a UPN is required.
---------- EXAMPLE 2 ----------
$settings = New-Object Delegate365.Api.Core.Models.AdministratorSettings
$settings.Email = 'john.doe@delegate365.com'
$settings.Phone = ''
$settings.UsageLocation = 'US'
$settings.DailyNotifications = $false
New-DAdministrator -UserPrincipalName john.doe@delegate365.com `
-OrganizationalUnits 'Paris', 'New York' `
-Domains 'atwork-it.com', 'delegate365.com' `
-D365Permission 'Portal Admin'`
-Settings $settings
Additional parameters and settings can be set the new user in one step.
RELATED LINKS
Delegate365 support https://support.delegate365.com/
SYNOPSIS
Creates a new administrator in Delegate365.
SYNTAX
New-DAdministrator [-UserPrincipalName] <string> [[-OrganizationalUnits] <string[]>] [[-Domains] <string[]>]
[[-Settings] <AdministratorSettings>] [[-D365Permission] <string>] [<CommonParameters>]
DESCRIPTION
New-DAdministrator creates a new administrator in Delegate365. To use Delegate365, a user must be added as
Administrator in the Administrator's list. Permissions and assignments to OU's and to domains define the scope for
an administrator. Administrators can be users in the same Office 365 tenant, or can be external users with an
Office 365 work account. Optional, additional properties can be handed over to the command, see the example. The
output shows the created admin object.
PARAMETERS
-UserPrincipalName <string>
UserPrincipalName is the login name of the new admin and is required.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-OrganizationalUnits <string[]>
OrganizationalUnits can be a string array, that can be separated by comma, e.g. 'Paris', 'New York'.
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Domains <string[]>
Domains can be a string array, that can be separated by comma, e.g. 'atwork-it.com', 'delegate365.com'.
Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Settings <AdministratorSettings>
Settings allow to set the notification email, phone number and other settings for the admin.
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-D365Permission <string>
D365Permission define the name of the permission policy that shall be assigned.
Required? false
Position? 6
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.Administrator
---------- EXAMPLE 1 ----------
New-DAdministrator -UserPrincipalName 'john.doe@delegate365.com'
For creating a new admin, a UPN is required.
---------- EXAMPLE 2 ----------
$settings = New-Object Delegate365.Api.Core.Models.AdministratorSettings
$settings.Email = 'john.doe@delegate365.com'
$settings.Phone = ''
$settings.UsageLocation = 'US'
$settings.DailyNotifications = $false
New-DAdministrator -UserPrincipalName john.doe@delegate365.com `
-OrganizationalUnits 'Paris', 'New York' `
-Domains 'atwork-it.com', 'delegate365.com' `
-D365Permission 'Portal Admin'`
-Settings $settings
Additional parameters and settings can be set the new user in one step.
RELATED LINKS
Delegate365 support https://support.delegate365.com/