new-Office365Contact.ps1
|
<#
.SYNOPSIS This function creates the new distribution contact in office 365. .DESCRIPTION This function creates the new distribution contact in office 365. .PARAMETER originalContactConfiguration The original configuration of the contact on premises. .PARAMETER contactTypeOverride Submits the contact type override of specified by the administrator at run time. .OUTPUTS None .EXAMPLE new-Office365contact -contactTypeOverride "Security" -originalContactConfiguration adConfigVariable. #> Function new-office365contact { [cmdletbinding()] Param ( [Parameter(Mandatory = $true)] $originalContactConfiguration, [Parameter(Mandatory = $true)] $office365contactConfiguration ) #Declare function variables. [string]$functioncontactType=$NULL #Holds the return information for the contact query. [string]$functionMailNickName = "" [string]$functionName = ((Get-Date -Format FileDateTime)+(Get-Random)).tostring() $functioncontact = $NULL #Start function processing. Out-LogFile -string "********************************************************************************" Out-LogFile -string "BEGIN New-Office365contact" Out-LogFile -string "********************************************************************************" #Log the parameters and variables for the function. Out-LogFile -string ("originalContactConfiguration = ") out-logfile -string $originalContactConfiguration out-logfile -string ("Office365contactConfiguration = ") out-logfile -string $office365contactConfiguration #Calculate the contact type to be utilized. #Three values - either NULL,Security,or Distribution. out-logfile -string ("Random contact name: "+$functionName) #Create the distribution contact in office 365. try { out-logfile -string "Creating the distribution contact in Office 365." $functioncontact = new-o365mailcontact -externalEmailAddress $office365contactConfiguration.externalEmailAddress -name $functionName -errorAction STOP out-logfile -string $functioncontact } catch { Out-LogFile -string $_ -isError:$TRUE } Out-LogFile -string "END New-Office365contact" Out-LogFile -string "********************************************************************************" return $functioncontact } |