New-MBSAPIAdministrator

---

Creates an Administrator for MBS

New-MBSAPIAdministrator
		[-Email] <String>
		[[-FirstName] <String>]
		[[-LastName] <String>]
		[[-Companies] <String[]>]
		[[-Enabled] <Boolean>]
		[-Password] <SecureString>
		[[-SendEmailInstruction] <Boolean>] 
		[[-ProfileName] <String>]
		[-PermissionsModels] <String>
		[<CommonParameters>]

---

Description

Calls the POST api/Administrators API to create a new administrator according to the specified parameters.

---

Examples

Example 1: Create a new administrator with specific permissions.

PS C:\> $PermissionModels = '{
	"Users": 1,
	"StorageLimit": 0,
	"Notification": 0,
	"OnlineAccess": 0,
	"Licenses": 0,
	"Billing": 0,
	"Monitiring": 0,
	"RemoteDeploy": 1,
	"RemoteManagment": 0,
	"HelpMarketing": 0,
	"AuditLog": 0,
	"PSA": 0,
	"Administrators": 0,
	"Rebranding": 0,
	"Storage": 0,
	"ADS": 0,
	"LicenseBuy": 0,
	"LicenseActivate": 0,
	"StorageUsage": 1,
	"CapacityReport": 0,
	"GoogleApps": 0,
	"Dashboard": 0
	}'

	New-MBSAPIAdministrator -Email 'QQQ@test.com' -password (ConvertTo-SecureString -Force -asplaintext 'test') -SendEmailInstruction $false -FirstName admin -LastName adminson -Enabled $true -PermissionsModels $PermissionModels -ProfileName profile    

---

Parameters

-Email

Email address of the administrator

Type	String
Required:	true
Position	1
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-FirstName

First name of the administrator

Type	String
Required:	false
Position	2
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-LastName

Last name of the administrator

Type	String
Required:	false
Position	3
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-Companies

List of companies the adminstrator will have access to.

Type	String[]
Required:	false
Position	4
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-Enabled

Whether the administrator should be enabled after creation

Type	Boolean
Required:	false
Position	5
Default value:	True
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-Password

Password

Type	SecureString
Required:	true
Position	6
Default value:
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-SendEmailInstruction

Whether or not to send instructions to the new administrator

Type	Boolean
Required:	false
Position	7
Default value:	False
Accept pipeline input:	true (ByPropertyName)
Accept wildcard characters:	false

-ProfileName

Profile name used with MSP360 PowerShell for MBS API (set via Set-MBSApiCredential)

Type	String
Required:	false
Position	8
Default value:
Accept pipeline input:	false
Accept wildcard characters:	false

-PermissionsModels

JSON for administrator permissions. Valid fields can be found here: https://api.mspbackups.com/Help/ResourceModel?modelName=PermissionsModels Example can be found here: https://api.mspbackups.com/Help/Api/POST-api-Administrators

Type	String
Required:	true
Position	9
Default value:
Accept pipeline input:	true (ByPropertyName)
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).

Notes

Author: Andrey Oshukov