O365Connect.psm1
|
function Connect-Office365 { <# .SYNOPSIS This function will prompt for credentials, load module MSOLservice, load implicit modules for Office 365 Services (AD, Lync, Exchange) using PSSession. .DESCRIPTION This function will prompt for credentials, load module MSOLservice, load implicit modules for Office 365 Services (AD, Lync, Exchange) using PSSession. .EXAMPLE Connect-Office365 This will prompt for your credentials and connect to the Office365 services .EXAMPLE Connect-Office365 -verbose This will prompt for your credentials and connect to the Office365 services. Additionally you will see verbose messages on the screen to follow what is happening in the background .NOTES Francois-Xavier Cat lazywinadmin.com @lazywinadm #> [PoshBot.BotCommand(CommandName = 'O365Connect')] [CmdletBinding()] PARAM () BEGIN { TRY { #Modules IF (-not (Get-Module -Name MSOnline -ListAvailable)) { Write-Verbose -Message "BEGIN - Import module Azure Active Directory" Import-Module -Name MSOnline -ErrorAction Stop -ErrorVariable ErrorBeginIpmoMSOnline } IF (-not (Get-Module -Name LyncOnlineConnector -ListAvailable)) { Write-Verbose -Message "BEGIN - Import module Lync Online" Import-Module -Name LyncOnlineConnector -ErrorAction Stop -ErrorVariable ErrorBeginIpmoLyncOnline } } CATCH { Write-Warning -Message "BEGIN - Something went wrong!" IF ($ErrorBeginIpmoMSOnline) { Write-Warning -Message "BEGIN - Error while importing MSOnline module" } IF ($ErrorBeginIpmoLyncOnline) { Write-Warning -Message "BEGIN - Error while importing LyncOnlineConnector module" } Write-Warning -Message $error[0].exception.message } } PROCESS { TRY { # CREDENTIAL Write-Verbose -Message "PROCESS - Ask for Office365 Credential" $O365cred = Get-Credential -ErrorAction Stop -ErrorVariable ErrorCredential # AZURE ACTIVE DIRECTORY (MSOnline) Write-Verbose -Message "PROCESS - Connect to Azure Active Directory" Connect-MsolService -Credential $O365cred -ErrorAction Stop -ErrorVariable ErrorConnectMSOL # EXCHANGE ONLINE (Implicit Remoting module) Write-Verbose -Message "PROCESS - Create session to Exchange online" $ExchangeURL = "https://ps.outlook.com/powershell/" $O365PS = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri $ExchangeURL -Credential $O365cred -Authentication Basic -AllowRedirection -ErrorAction Stop -ErrorVariable ErrorConnectExchange Write-Verbose -Message "PROCESS - Open session to Exchange online (Prefix: Cloud)" Import-PSSession -Session $O365PS –Prefix ExchCloud # LYNC ONLINE (LyncOnlineConnector) Write-Verbose -Message "PROCESS - Create session to Lync online" $lyncsession = New-CsOnlineSession –Credential $O365cred -ErrorAction Stop -ErrorVariable ErrorConnectExchange Import-PSSession -Session $lyncsession -Prefix LyncCloud # SHAREPOINT ONLINE (Implicit Remoting module) #Connect-SPOService -Url https://contoso-admin.sharepoint.com –credential $O365cred } CATCH { Write-Warning -Message "PROCESS - Something went wrong!" IF ($ErrorCredential) { Write-Warning -Message "PROCESS - Error while gathering credential" } IF ($ErrorConnectMSOL) { Write-Warning -Message "PROCESS - Error while connecting to Azure AD" } IF ($ErrorConnectExchange) { Write-Warning -Message "PROCESS - Error while connecting to Exchange Online" } IF ($ErrorConnectLync) { Write-Warning -Message "PROCESS - Error while connecting to Lync Online" } Write-Warning -Message $error[0].exception.message } } } Export-ModuleMember -Function 'Connect-Office365' |