start-replaceOffice365Unified.ps1

<#
    .SYNOPSIS
 
    This function begins the process of replacing the Office 365 unified group settings for groups that have been migrated that had cloud only dependencies.
 
    .DESCRIPTION
 
    This function begins the process of replacing the Office 365 unified group settings for groups that have been migrated that had cloud only dependencies.
 
    .PARAMETER office365Attribute
 
    The office 365 attribute.
 
    .PARAMETER office365Member
 
    The member that is being added.
 
    .PARAMETER groupSMTPAddress
 
    The member that is being added.
 
    .OUTPUTS
 
    None
 
    .EXAMPLE
 
    sstart-replaceOffice365 -office365Attribute Attribute -office365Member groupMember -groupSMTPAddress smtpAddess
 
    #>

    Function start-replaceOffice365Unified
    {
        [cmdletbinding()]

        Param
        (
            [Parameter(Mandatory = $true)]
            $office365Attribute,
            [Parameter(Mandatory = $true)]
            [string]$office365Member,
            [Parameter(Mandatory = $true)]
            [string]$groupSMTPAddress
        )

        #Output all parameters bound or unbound and their associated values.

        write-functionParameters -keyArray $MyInvocation.MyCommand.Parameters.Keys -parameterArray $PSBoundParameters -variableArray (Get-Variable -Scope Local -ErrorAction Ignore)

        [string]$isTestError="No"

        #Start function processing.

        Out-LogFile -string "********************************************************************************"
        Out-LogFile -string "BEGIN start-ReplaceOffice365Unified"
        Out-LogFile -string "********************************************************************************"

        #Log the parameters and variables for the function.

        $functionCommand=$NULL

        #Declare function variables.

        out-Logfile -string "Processing operation..."

        $functionCommand="set-o365UnifiedGroup -identity $office365Member -$office365Attribute @{add='$groupSMTPAddress'} -errorAction STOP"
        out-logfile -string ("The command to execute: "+$functionCommand)

        $scriptBlock = [scriptBlock]::create($functionCommand)

        out-logfile -string ("The script block to execute is: "+$scriptBlock)

        try {
            & $scriptBlock
        }
        catch {
            out-logfile -string $_
            $isTestError="Yes"
        }

        Out-LogFile -string "END start-replaceOffice365Unified"
        Out-LogFile -string "********************************************************************************"

        return $isTestError
    }