Difference between revisions of "Exchange Server Unified Messaging Management (OnPremise)"

From Hornbill
Jump to navigation Jump to search
(Replaced content with "This document can now be found at its new location in the [https://docs.hornbill.com/itom-packages/welcome Hornbill Document Library]. file:hornbill-document-librar...")
Tag: Replaced
Line 1: Line 1:
{{bluebanner|[[Main_Page|Home]] > [[Administration]] > [[IT_Operations_Management|IT Operations Management]] > [[ITOM_Package_Library|ITOM Package Library]] > Exchange Server Unified Messaging Management (OnPremise) |[[:Category:ITOM|Index]]}}
+
This document can now be found at its new location in the [https://docs.hornbill.com/itom-packages/welcome Hornbill Document Library].
[[File:microsoft_logo.png|300px]]     [[File:Microsoft_Exchange_(2019-present).svg.png|75px]]
 
{{IntroAndLinks|This package provides operations for On-Premise Exchange server unified messaging management, supported for use on Exchange Server version 2016.
 
  
Unified Messaging (UM) enables users to use voice mail and other features, including Outlook Voice Access and Call Answering Rules. UM combines voice messaging and email messaging into one mailbox that can be accessed from many different devices. Users can listen to their messages from their email Inbox or by using Outlook Voice Access from any telephone.
+
    [[file:hornbill-document-library.png|ITOM Package Reference|link=https://docs.hornbill.com/itom-packages/welcome]]
|
 
<!-- Related Links go here -->
 
:* [[IT_Operations_Management|IT Operations Management]]
 
:* [[Business_Process_Designer|Business Process Designer]]
 
:* [[Hornbill_KeySafe|KeySafe]]
 
}}
 
 
 
==Target Environment Requirements==
 
===Script Execution Machine Requirements===
 
* The package utilises the Exchange Server PowerShell provided by the Exchange Management Shell, which requires installation on the target device.
 
See the [https://docs.microsoft.com/en-us/exchange/plan-and-deploy/post-installation-tasks/install-management-tools?view=exchserver-2019 Install Exchange Management Tools] for more information
 
 
 
* If the script execution policy on the machine executing these operations is set to Restricted, then this will need to be updated to something less restrictive. If this is the case, you can use the Set Execution Policy operation within this package to update the Execution Policy on the target device before performing any of the other operations.
 
 
 
==KeySafe Configuration==
 
[[File:itomtarget_keysafe.png|300px|right]]
 
 
 
When creating SIS jobs for operations contained within this package, they need to be run on the target machine as a user who has the correct privileges on the target.
 
 
 
To configure your '''Target Machine''' account authentication in '''[[Hornbill_KeySafe|KeySafe]]''':
 
 
 
* In the Admin console, navigate to: System > Security > KeySafe;
 
* Click on + then select <code>Username + Password</code>;
 
* Give the KeySafe Key a Title (this is the name/identifier for the target machine account as you will see it when creating an IT Automation Job, or adding an IT Automation node to a Business Process or Runbook);
 
* Optionally add a description;
 
* Populate the Username field with the domain/local account username for the account being used on the target machine;
 
* Populate the Password field with the password for the above account;
 
* Select Create Key to save.
 
 
 
Once you have created your KeySafe Key, you can then use it when creating IT Automation Jobs from this package. See screenshots to the right for examples.
 
 
 
==Package Operations==
 
 
 
The Exchange Server Unified Messaging Management (OnPremise) package contains the following operations, than can be used to create ITOM Jobs directly, or included in your [[Business_Process_Designer|Business Processes]] and/or IT Operations Management Runbooks. 
 
 
 
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
 
===Enable UM Mailbox===
 
<div class="mw-collapsible-content">
 
Enables a Mailbox to utilise Unified Messaging, with the settings from a UM mailbox policy applied. After allowing the mailbox for use with Unified Messaging, the user can use the UM features included in Microsoft Exchange.
 
 
 
====Input Parameters====
 
 
 
* <code>Identity</code> '''MANDATORY''' - Specifies the mailbox that you want to view. You can use any value that uniquely identifies the mailbox: Name, Alias, Distinguished name (DN) etc...
 
* <code>Extensions</code> - Specifies the extension number for the user. Either a single extension number or a comma separated list can be specified.
 
* <code>Pin</code> - Specifies the value for the initial PIN that's used for the UM mailbox.  
 
* <code>NotifyEmail</code> - Specifies the email address where the Unified Messaging welcome message is sent
 
* <code>PinExpired</code> - Specifies whether the PIN is treated as expired, and will need to be reset on the next login
 
* <code>UMMailboxPolicy</code> '''MANDATORY''' - Specifies the UM mailbox policy that you want to associate with the mailbox.: Name, Distinguished name (DN) ,GUID etc.
 
* <code>SIPResourceIdentifier</code> - Specifies the SIP address or E.164 address for the user.
 
* <code>DomainController</code> - Specifies the domain controller that's used to read data from or write data to Active Directory
 
* <code>SendWelcomeMail</code> - specifies whether you want to send a welcome message after the mailbox has been enabled for UM.
 
 
 
====Output Parameters====
 
 
 
* <code>outcome</code>  The outcome of the operation (OK/FAIL) 
 
* <code>errors</code>  Any errors returned by the operation 
 
 
 
</div></div>
 
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
 
===Disable UM Mailbox===
 
<div class="mw-collapsible-content">
 
Disables a Mailbox from utilising Unified Messaging; the user can no longer use the UM features included in Microsoft Exchange. Microsoft Exchange Unified Messaging service no longer handle calls for the associated extension number. The mailbox continues to function normally for all other operations unrelated to Unified Messaging.
 
 
 
====Input Parameters====
 
 
 
* <code>Identity</code> - Specifies the mailbox that you want to view. You can use any value that uniquely identifies the mailbox: Name, Alias, Distinguished name (DN) etc...
 
* <code>DomainController</code> - Specifies the domain controller that's used to read data from or write data to Active Directory
 
 
 
====Output Parameters====
 
 
 
* <code>outcome</code>  The outcome of the operation (OK/FAIL) 
 
* <code>errors</code>  Any errors returned by the operation 
 
 
 
</div></div>
 
 
 
 
 
[[Category:ITOM]]
 

Revision as of 14:50, 12 February 2024

This document can now be found at its new location in the Hornbill Document Library.

   ITOM Package Reference