README.md

HelloID-Conn-SA-Full-Exchange-Online-SharedMailboxDelete

Important

This repository contains the connector and configuration code only. The implementer is responsible for acquiring the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.

 

Table of contents

• HelloID-Conn-SA-Full-Exchange-Online-SharedMailboxDelete
  • Table of contents
  • Requirements
  • Remarks
  • Introduction
    • Description
    • ExchangeOnlineManagement module
    • Form Options
    • Task Actions
  • Connector Setup
    • Variable Library - User Defined Variables
  • Getting help
  • HelloID docs

Requirements

1. HelloID Environment:
   • Set up your HelloID environment.
2. Exchange Online PowerShell V3 module:
   • This HelloID Service Automation Delegated Form uses the Exchange Online PowerShell V3 module. A HelloID agent is required to import the Exchange Online module.
3. Entra ID Application Registration:
   • App registration with API permissions select APIs my organization uses search for Office 365 Exchange Online. Select Application permissions:
     • Exchange.ManageAsApp
   • The following information for the app registration is needed in HelloID:
     • Application (client) ID
     • Directory (tenant) ID
     • Secret Value
4. Entra ID Role:
   • The Exchange Administrator should provide the required permissions for any task in Exchange Online PowerShell.
     • To assign the role(s) to your application, navigate to Roles and administrators.
     • Search and select Exchange Administrator click Add assignments. Select the app registration that you created in step 3.
     • Click Next, assignment type Active.

Remarks

• None at this time.

Introduction

Description

HelloID-Conn-SA-Full-Exchange-Online-SharedMailboxDelete is a template designed for use with HelloID Service Automation (SA) Delegated Forms. It can be imported into HelloID and customized according to your requirements.

By using this delegated form, you can delete a shared mailbox in Exchange Online. The following options are available:

1. Search and select the shared mailbox
2. The task will delete the shared mailbox

ExchangeOnlineManagement module

The ExchangeOnlineManagement module provide a set of commands to interact with Exchange Online. The commands used are listed in the table below.

Endpoint	Description
Get-User	Required for Get-Mailbox / Remove-Mailbox
Get-Mailbox	To retrieve the shared mailboxes from Exchange Online
Remove-Mailbox	To remove the shared mailbox in Exchange Online

Form Options

The following options are available in the form:

1. Search and select shared mailbox:
   • Search and select the shared mailbox that needs to be deleted.

Task Actions

The following actions will be performed after submitting the form:

1. Remove the selected shared mailbox:
   • The Remove-Mailbox command will be used to delete the shared mailbox.

Connector Setup

Variable Library - User Defined Variables

The following user-defined variables are used by the connector. Ensure that you check and set the correct values required to connect to the API.

Setting	Description
EntraOrganization	The name of the organization to connect to and where the Entra ID App Registration exists.
EntraTenantId	The ID to the Tenant in Microsoft Entra ID
EntraAppId	The ID to the App Registration in Microsoft Entra ID
EntraAppSecret	The Client Secret to the App Registration in Microsoft Entra ID

Getting help

Tip

For more information on Delegated Forms, please refer to our documentation pages.

Tip

 If you need help, feel free to ask questions on our forum.

HelloID docs

The official HelloID documentation can be found at: https://docs.helloid.com/