New-UcmOffice365User -todo

Checks for and creates a new blank Office 365 User

Description

Checks for and creates a new blank Office 365 user

Used by other UcmPsTools Cmdlets, but can be handy for some situations where you need to create a user account for things that can't be sorted with a Teams resource account.

Examples include Teams Meeting Room accounts, Common Area Phones, etc.

Note: All accounts will be "Cloud born". Thus, this cmdlet cannot create accounts that use a domain managed via an on-prem AD instance. (AADSync/DirSync or Shared Sip Space domains, for example)

Example

Outputs

This Cmdet returns a PSCustomObject with multiple keys to indicate the results.

$Return.Status

$Return.Status returns one of four values "OK" : The operation was successful, nothing of concern "Warn" : The operation was successful, but there is something you should be mindful of (For example trying to create a forward that already exists, or running low on licences to assign) More information will be found in $Return.Message "Error" : The operation was unsuccessful, Something happened when attempting to perform the operation that the function couldn't handle automatically, check $Return.Message for more information "Unknown" : Cmdlet reached the end of the function without returning anything, this shouldn't happen, if it does please log an issue on GitHub with your relevant log files.

$Return.Message

$Return.Message returns descriptive text relevant to the status, mainly for logging, reporting or diagnosis.

Return.Status can return one of four values.