Functions/Connect-Office365SecurityAndComplianceAdminAccount.ps1
<#
.SYNOPSIS This function connects to Office 365 Security and Compliance Center using admin account credentials or a MSPComplete Endpoint. .DESCRIPTION This function connects to Office 365 Security and Compliance Center using admin account credentials or a MSPComplete Endpoint. It returns whether the connection and logon was successful. .EXAMPLE Connect-Office365SecurityAndComplianceAdminAccount -Endpoint $Endpoint .EXAMPLE $Endpoint | Connect-Office365SecurityAndComplianceAdminAccount .EXAMPLE Connect-Office365SecurityAndComplianceAdminAccount -Username $username -Password $password #> function Connect-Office365SecurityAndComplianceAdminAccount { [CmdletBinding(PositionalBinding=$false)] [OutputType([String])] param ( # The username of the Office 365 Security and Compliance Center admin account. [Parameter(Mandatory=$true, ParameterSetName="credential")] [string]$username, # The password of the Office 365 Security and Compliance Center admin account. [Parameter(Mandatory=$true, ParameterSetName="credential")] [SecureString]$password, # The MSPComplete Endpoint for the Office 365 Security and Compliance Center admin credentials. [Parameter(Mandatory=$true, ParameterSetName="endpoint", ValueFromPipeline=$true)] $endpoint ) # If given endpoint, retrieve username and password if ($PSCmdlet.ParameterSetName -eq "endpoint") { $office365Credential = $endpoint.Credential $username = $office365Credential.Username } # Create the Office 365 Security and Compliance Center credential from the given username and password else { $office365Credential = [PSCredential]::new($username, $password) } # Logon to Office 365 Security and Compliance Center try { $office365Session = New-PSSession -ConfigurationName Microsoft.Exchange ` -ConnectionUri "https://ps.compliance.protection.outlook.com/powershell-liveid/" ` -Credential $office365Credential -Authentication Basic -AllowRedirection -Name "Office365SecurityAndCompliance" # Additional Import-Module ensures that imported cmdlets are visible globally Import-Module (Import-PSSession $office365Session -DisableNameChecking -AllowClobber -Prefix "SC_") -Global # Logon was successful Write-Information "Logon to Office 365 Security and Compliance Center successful with username '$($username)'." return $true } # Logon was unsuccessful catch { Write-Error "Exception while attempting to logon to Office 365 Security and Compliance Center with username '$($username)'.`r`n$($_.Exception.Message)" return $false } } |