Partager via

How to: Disable the Built-In UI

  • Article

 

Applies To: Windows Server 2012 Essentials

The new email UI features for the Hosted Email Integration (HEI) framework are optional: that is, while the new UI elements are enabled by default, you can choose to disable them. However, the new UI elements contain most of the standard features necessary to administer an email service. Therefore, it is recommended that you disable the new elements only if you plan on replacing the elements with your UI. Alternately, you can disable the new UI elements if your email solution does not need those features. You can disable the new UI elements by identifying them in the Configuration XML file that goes along with your add-in installation package.

To disable the built-in email administrative UI elements

  1. In your XML configuration file, in the HideBuiltinUI Element, list the UI elements you wish to disable.

    The following table describes the XML elements, and the associated UI element.

    XML element Description
    HEAddUser Add user task
    HERemoveUser Remove user task
    HEUserProperty User Property dialog
    HEEnableUser Enable user task
    HEDisableUser Disable user task
    HEResetPassword Reset admin password task
    HEUserTab Dashboard user tab

    Note

    The XML elements in the configuration file do not disable the entire UI. Instead, the configuration file disables only the UI additions that interact with a hosted email service.

  2. Continue to create and implement your configuration file normally. For more information, see How to: Create a Configuration XML File.

Example

The following XML sample describes a configuration file that disables every built-in email UI.

<?xml version="1.0" encoding="utf-8" ?>  
<addin id="1F8D7206-D1F1-476C-A1DE-D1560634F8FB" name="Hosted Email Add-in" basedir="c:\program files\Windows Server\Bin" type="Microsoft.WindowsServerSolutions.HostedEmailIntegration, CustomAddin" >  
  <Service>  
    <ShortName>Contoso Services</ShortName>  
    <FullName>Contoso Services</FullName>  
    <Name>Contoso Computer</Name>  
    <Provider>  
      <Address>One Microsoft Way, Redmond, WA 98052</Address>  
      <Website>https://www.contoso.com</Website>  
    </Provider>  
    <ServiceSignupURL>https://contoso.com/signup</ServiceSignupURL>  
    <ServiceUserPortal>https://contoso.com/portal</ServiceUserPortal>  
<ServicesDescription>Contoso Services deliver productivity and collaboration tools as a subscription service. With Contoso Services your organization can provide network users with a full set of cost efficient productivity tools that are compliant and secure.  
</ServicesDescription>  
    <LogoImage>Contoso\Logo.PNG</LogoImage>  
    <SupportContact>  
      <Phone>400-888-8888</Phone>  
      <Email>support@contoso.com</Email>  
    </SupportContact>  
  </Service>  
  
  <HideBuiltinUI>  
    <UIAddin>HEAddUser</UIAddin>  
    <UIAddin>HERemoveUser</UIAddin>  
    <UIAddin>HEUserProperty</UIAddin>  
    <UIAddin>HEEnableUser</UIAddin>  
    <UIAddin>HEDisableUser</UIAddin>  
    <UIAddin>HEResetPassword</UIAddin>  
    <UIAddin>HEUserTab</UIAddin>  
</HideBuiltinUI>  
  
  <PasswordSync>  
    <PasswordPolicyOnServer level="Medium" minlength="8"></PasswordPolicyOnServer>  
  </PasswordSync>  
</addin>