123 lines
5.6 KiB
PowerShell
123 lines
5.6 KiB
PowerShell
function Connect-M365Suite {
|
|
[OutputType([void])]
|
|
[CmdletBinding()]
|
|
param (
|
|
[Parameter(Mandatory = $false)]
|
|
[string]$TenantAdminUrl,
|
|
|
|
[Parameter(Mandatory = $false)]
|
|
[CISAuthenticationParameters]$AuthParams,
|
|
|
|
[Parameter(Mandatory)]
|
|
[string[]]$RequiredConnections,
|
|
|
|
[Parameter(Mandatory = $false)]
|
|
[switch]$SkipConfirmation
|
|
)
|
|
|
|
$VerbosePreference = if ($SkipConfirmation) { "SilentlyContinue" } else { "Continue" }
|
|
$tenantInfo = @()
|
|
$connectedServices = @()
|
|
|
|
try {
|
|
if ($RequiredConnections -contains "Microsoft Graph" -or $RequiredConnections -contains "EXO | Microsoft Graph") {
|
|
try {
|
|
Write-Verbose "Connecting to Microsoft Graph..."
|
|
if ($AuthParams) {
|
|
Connect-MgGraph -CertificateThumbprint $AuthParams.ClientCertThumbPrint -AppId $AuthParams.ClientId -TenantId $AuthParams.TenantId -NoWelcome | Out-Null
|
|
} else {
|
|
Connect-MgGraph -Scopes "Directory.Read.All", "Domain.Read.All", "Policy.Read.All", "Organization.Read.All" -NoWelcome | Out-Null
|
|
}
|
|
$graphOrgDetails = Get-MgOrganization
|
|
$tenantInfo += [PSCustomObject]@{
|
|
Service = "Microsoft Graph"
|
|
TenantName = $graphOrgDetails.DisplayName
|
|
TenantID = $graphOrgDetails.Id
|
|
}
|
|
$connectedServices += "Microsoft Graph"
|
|
Write-Verbose "Successfully connected to Microsoft Graph."
|
|
} catch {
|
|
throw "Failed to connect to Microsoft Graph: $($_.Exception.Message)"
|
|
}
|
|
}
|
|
|
|
if ($RequiredConnections -contains "EXO" -or $RequiredConnections -contains "AzureAD | EXO" -or $RequiredConnections -contains "Microsoft Teams | EXO" -or $RequiredConnections -contains "EXO | Microsoft Graph") {
|
|
try {
|
|
Write-Verbose "Connecting to Exchange Online..."
|
|
if ($AuthParams) {
|
|
Connect-ExchangeOnline -AppId $AuthParams.ClientId -CertificateThumbprint $AuthParams.ClientCertThumbPrint -Organization $AuthParams.OnMicrosoftUrl -ShowBanner:$false | Out-Null
|
|
} else {
|
|
Connect-ExchangeOnline -ShowBanner:$false | Out-Null
|
|
}
|
|
$exoTenant = (Get-OrganizationConfig).Identity
|
|
$tenantInfo += [PSCustomObject]@{
|
|
Service = "Exchange Online"
|
|
TenantName = $exoTenant
|
|
TenantID = "N/A"
|
|
}
|
|
$connectedServices += "EXO"
|
|
Write-Verbose "Successfully connected to Exchange Online."
|
|
} catch {
|
|
throw "Failed to connect to Exchange Online: $($_.Exception.Message)"
|
|
}
|
|
}
|
|
|
|
if ($RequiredConnections -contains "SPO") {
|
|
try {
|
|
Write-Verbose "Connecting to SharePoint Online..."
|
|
if ($AuthParams) {
|
|
Connect-PnPOnline -Url $AuthParams.SpAdminUrl -ClientId $AuthParams.ClientId -Tenant $AuthParams.OnMicrosoftUrl -Thumbprint $AuthParams.ClientCertThumbPrint | Out-Null
|
|
} else {
|
|
Connect-SPOService -Url $TenantAdminUrl | Out-Null
|
|
}
|
|
$tenantName = if ($AuthParams) { (Get-PnPSite).Url } else { (Get-SPOCrossTenantHostUrl).Host }
|
|
$tenantInfo += [PSCustomObject]@{
|
|
Service = "SharePoint Online"
|
|
TenantName = $tenantName
|
|
}
|
|
$connectedServices += "SPO"
|
|
Write-Verbose "Successfully connected to SharePoint Online."
|
|
} catch {
|
|
throw "Failed to connect to SharePoint Online: $($_.Exception.Message)"
|
|
}
|
|
}
|
|
|
|
if ($RequiredConnections -contains "Microsoft Teams" -or $RequiredConnections -contains "Microsoft Teams | EXO") {
|
|
try {
|
|
Write-Verbose "Connecting to Microsoft Teams..."
|
|
if ($AuthParams) {
|
|
Connect-MicrosoftTeams -TenantId $AuthParams.TenantId -CertificateThumbprint $AuthParams.ClientCertThumbPrint -ApplicationId $AuthParams.ClientId | Out-Null
|
|
} else {
|
|
Connect-MicrosoftTeams | Out-Null
|
|
}
|
|
$teamsTenantDetails = Get-CsTenant
|
|
$tenantInfo += [PSCustomObject]@{
|
|
Service = "Microsoft Teams"
|
|
TenantName = $teamsTenantDetails.DisplayName
|
|
TenantID = $teamsTenantDetails.TenantId
|
|
}
|
|
$connectedServices += "Microsoft Teams"
|
|
Write-Verbose "Successfully connected to Microsoft Teams."
|
|
} catch {
|
|
throw "Failed to connect to Microsoft Teams: $($_.Exception.Message)"
|
|
}
|
|
}
|
|
|
|
if (-not $SkipConfirmation) {
|
|
Write-Verbose "Connected to the following tenants:"
|
|
foreach ($tenant in $tenantInfo) {
|
|
Write-Verbose "Service: $($tenant.Service) | Tenant: $($tenant.TenantName)"
|
|
}
|
|
$confirmation = Read-Host "Do you want to proceed with these connections? (Y/N)"
|
|
if ($confirmation -notlike 'Y') {
|
|
Disconnect-M365Suite -RequiredConnections $connectedServices
|
|
throw "User aborted connection setup."
|
|
}
|
|
}
|
|
} catch {
|
|
$VerbosePreference = "Continue"
|
|
throw "Connection failed: $($_.Exception.Message)"
|
|
} finally {
|
|
$VerbosePreference = "Continue"
|
|
}
|
|
} |