Export (0) Print
Expand All

Configure mobile accounts in SharePoint 2013

 

Applies to: SharePoint Server 2013, SharePoint Foundation 2013

Topic Last Modified: 2013-12-18

Summary: Learn how to subscribe to SMS alerts for your mobile device in SharePoint 2013.

This article discusses how to configure and manage a mobile account for SharePoint Server 2013 to enable users to subscribe to alerts that are sent by using Short Message Service (SMS). The alerts are sent to users' mobile phones when changes are made to a SharePoint list or item.

A SharePoint site is usually located on an intranet. As a result, access to the SharePoint site can be difficult when users are away from the office — for example, when they are traveling or attending a business dinner. The mobile alert feature enables users to react quickly when they receive an SMS alert that an item in a SharePoint list has changed.

You can configure one mobile account for all web applications in a server farm, or you can configure the mobile account for a specific web application. However, you can only configure one mobile account in the farm. The scale of your implementation might determine whether you configure the mobile account for the farm or for a specific web application. If you configure the mobile account for a server farm, everyone in the organization can subscribe to alerts. This is useful, for example, in a small organization in which management wants all users to receive certain alerts. If you have several web applications that divide your organization into groups, you might want to configure a mobile account for only one of those groups. For example, you want to configure a mobile account to enable everyone in the sales group to subscribe to alerts.

Before you perform these procedures, confirm the following:

  • The server farm account has permission to access the Internet for sending alerts.

  • You have obtained the root certificate for the service provider's HTTPS web address. You can obtain the root certificate from your service provider or by using your web browser.

In this article:

Before you configure a mobile account, you must import the root certificate of the service provider's HTTPS web address, and then create a trusted root authority. This step can only be performed manually by using Windows PowerShell.

To import a root certificate and create a trusted root authority by using Windows PowerShell
  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin. Additionally, you must be a member of the Farm Administrators group and a member of the Administrators group on the local computer that is running Windows PowerShell.

  2. Start SharePoint 2013 Central Administration.

    • For Windows Server 2008 R2:

      • Click Start, click Microsoft SharePoint 2013 Products, and then click SharePoint 2013 Central Administration.

    • For Windows Server 2012:

      • On the Start screen, click SharePoint 2013 Central Administration.

        If SharePoint 2013 Central Administration is not on the Start screen:

      • Right-click Computer, click All apps, and then click SharePoint 2013 Central Administration.

    For more information about how to interact with Windows Server 2012, see Common Management Tasks and Navigation in Windows Server 2012.

  3. To get the root certificate, at the Windows PowerShell command prompt, type the following command:

    $cert = Get-PfxCertificate <ObtainedCertificatePath>
    

    To create a trusted root authority, at the Windows PowerShell command prompt, type the following command:

    New-SPTrustedRootAuthority -Name <Name> -Certificate $cert
    

    Where:

    • <Name> is the name of the trusted root authority that you want to create.

    • <ObtainedCertificatePath> is the location of the root certificate file.

    NoteNote:
    In the Certificate window, on the Certification Path tab, ensure that you use only the root certificate, and not the other certificates listed. The SharePoint Trusted Root Authorities list should only list root certificates.

For more information, see New-SPTrustedRootAuthority.

You can configure a mobile account for a server farm or for a specific web application, by using either Central Administration or Windows PowerShell.

NoteNote:
If you cannot configure a mobile account, you might have the wrong certificate file. In that case, contact your service provider.
To configure or edit a mobile account for a server farm by using Central Administration
  1. Verify that you have the following administrative credentials:

    • To configure a mobile account for a server farm, you must be a member of the Farm Administrators group on the computer that is running the SharePoint Central Administration website.

  2. On the Central Administration home page, click System Settings.

  3. On the System Settings page, in the E-Mail and Text Messages (SMS) section, click Configure mobile account.

  4. On the Mobile Account Settings page, in the Text Message (SMS) Service Settings section, click the Microsoft Office Online link to access a list of service providers.

  5. On the service provider page, in the Choose your wireless service provider's country/region list, select the country or region in which your wireless service provider is located.

  6. On the service provider page, in the Choose your current wireless service provider list, select the wireless service provider that you want to use.

    After you make this selection, you are directed to the website of the service provider that you selected. On the website, you apply for the SMS service. When you receive the required information from the service provider, return to the Mobile Accounts Settings page.

  7. In the The URL of Text Message (SMS) Service box, type the URL of the SMS service.

    NoteNote:
    Ensure that the service URL you enter is an HTTPS URL.
  8. In the User Name box and Password box, type the user name and password that you received from the SMS service provider.

  9. To confirm that the URL and user credentials are correct, click Test Service.

  10. Click OK.

To configure or edit a mobile account for a server farm by using Windows PowerShell
  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin. Additionally, you must be a member of the Farm Administrators group and a member of the Administrators group on the local computer that is running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2013 Products.

  4. Click SharePoint 2013 Management Shell.

  5. At the Windows PowerShell command prompt, type the following command:

    Set-SPMobileMessagingAccount -Identity sms -WebApplication <WebApplicationUrl> [-ServiceUrl <ServiceUrl>] [-UserId <UserId>] [-Password <Password>]
    

    Where:

    • <WebApplicationUrl> is the Central Administration URL.

    • <ServiceUrl> is the URL to server where the SMS service is located.

    • <UserId> is the user name that you received from the SMS service provider.

    • <Password> is the user password that you received from the SMS service provider.

    Example

    Set-SPMobileMessagingAccount -Identity sms -WebApplication http://myserver:8080 -ServiceUrl https://www.example.com/omsservice.asmx -UserId someone@example.com -Password password1
    

    Or, if you use the pipeline operator, type the following command:

    Get-SPWebApplication -Identity http://myserver:8080 | Set-SPMobileMessagingAccount -Identity sms -ServiceUrl https://www.example.com/omsservice.asmx -UserId someone@example.com -Password password1
    
    NoteNote:
    Ensure that the service URL you enter is an HTTPS URL.

For more information, see and Get-SPWebApplication.

To configure or edit a mobile account for a web application by using Central Administration
  1. Verify that you have the following administrative credentials:

    • To configure a mobile account for a server farm, you must be a member of the Farm Administrators group on the computer that is running Central Administration.

  2. On the Central Administration home page, in the Application Management section, click Manage web applications.

  3. On the Web Applications page, select the web application for which you want to configure a mobile account. In General Settings on the ribbon, click Mobile Account.

  4. On the Web Application Text Message (SMS) Service Settings page, in the Text Message (SMS) Service Settings section, click the Microsoft Office Online link to access a list of service providers.

  5. On the service provider page, in the Choose your wireless service provider’s country/region list, select the country or region in which your wireless service provider is located.

  6. On the service provider page, in the Choose your current wireless service provider list, select the wireless service provider that you want to use.

    After you make this selection, you are directed to the website of the service provider that you selected. On the website, you apply for the SMS service. When you receive the required information from the service provider, return to the Mobile Accounts Settings page and type the information.

  7. In the The URL of Text Message (SMS) Service box, type the URL of the SMS service.

    NoteNote:
    Ensure that the service URL you enter is an HTTPS URL.
  8. In the User Name box and Password box, type the user name and password that you received from the SMS service provider.

  9. To confirm that the URL and user credentials are correct, click Test Service.

  10. Click OK.

To configure or edit a mobile account for a web application by using Windows PowerShell
  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin. Additionally, you must be a member of the Farm Administrators group and a member of the Administrators group on the local computer that is running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2013 Products.

  4. Click SharePoint 2013 Management Shell.

  5. From the Windows PowerShell command prompt (that is, PS C:\>), type the following command:

    Set-SPMobileMessagingAccount -Identity sms -WebApplication <WebApplicationUrl> [-ServiceUrl <ServiceUrl>] [-UserId <UserId>] [-Password <Password>]
    

    Where:

    • <WebApplicationUrl> is the web application URL.

    • <ServiceUrl> is the URL to server where the SMS service is located.

    • <UserId> is the user name that you received from the SMS service provider.

    • <Password> is the user password that you received from the SMS service provider.

    Example

    Set-SPMobileMessagingAccount -Identity sms -WebApplication http://localhost -ServiceUrl https://www.example.com/omsservice.asmx -UserId someone@example.com -Password password1
    

    Or, if you use the pipeline operator, type the following command:

    Get-SPWebapplication -Identity http://localhost | Set-SPMobileMessagingAccount -Identity sms -ServiceUrl https://www.example.com/omsservice.asmx -UserId someone@example.com -Password password1
    
    NoteNote:
    Ensure that the service URL you enter is an HTTPS URL.

For more information, see Set-SPMobileMessagingAccount and Get-SPWebApplication.

You can retrieve mobile account information for a server farm or for a web application by using Windows PowerShell. You might want to do this to view the mobile account information or, for example, to verify that the set cmdlet works correctly.

To retrieve mobile account information for a server farm by using Windows PowerShell
  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin. Additionally, you must be a member of the Farm Administrators group and a member of the Administrators group on the local computer that is running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2013 Products.

  4. Click SharePoint 2013 Management Shell.

  5. At the Windows PowerShell command prompt, type the following command:

    Get-SPMobileMessagingAccount -WebApplication <WebApplicationUrl>
    

    Where <WebApplicationUrl> is the Central Administration URL.

    Example

    Get-SPMobileMessagingAccount -WebApplication http://myserver
    

    Or, if you use the pipeline operator, type the following command:

    Get-SPWebApplication -Identity http://myserver | Get-SPMobileMessagingAccount -AccountType sms
    

For more information, see Get-SPMobileMessagingAccount and Get-SPWebApplication.

To retrieve mobile account information for a web application by using Windows PowerShell
  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin. Additionally, you must be a member of the Farm Administrators group and a member of the Administrators group on the local computer that is running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2013 Products.

  4. Click SharePoint 2013 Management Shell.

  5. At the Windows PowerShell command prompt, type the following command:

    Get-SPMobileMessagingAccount -WebApplication <WebApplicationUrl>
    

    Where <WebApplicationUrl> is the web application URL.

    Example

    Get-SPMobileMessagingAccount -WebApplication http://localhost
    

    Or, if you use the pipeline operator, type the following command:

    Get-SPWebApplication -Identity http://localhost | Get-SPMobileMessagingAccount -AccountType sms
    

For more information, see Get-SPMobileMessagingAccount and Get-SPWebApplication.

You can delete a mobile account for a server farm or for a web application. This makes the account unavailable so that users can no longer subscribe to SMS alerts. However, it does not delete the account that you set up with the service provider. You might want to delete a mobile account if, for example, the organization decides that there is no business value in sending out SMS alerts to users.

NoteNote:
There is no equivalent Windows PowerShell functionality.
To delete a mobile account for a server farm
  1. Verify that you have the following administrative credentials:

    • To delete a mobile account for a server farm, you must be a member of the Farm Administrators group on the computer that is running Central Administration.

  2. On the Central Administration home page, click System Settings.

  3. On the System Settings page, in the E-mail and Text Messages (SMS) section, click Configure mobile account.

  4. On the Mobile Account Settings page, clear entries from all the boxes, and then click OK.

To delete a mobile account for a web application
  1. Verify that you have the following administrative credentials:

    • To delete a mobile account for a server farm, you must be a member of the Farm Administrators group on the computer that is running Central Administration.

  2. On the Central Administration home page, in the Application Management section, click Manage web applications.

  3. In General Settings on the ribbon, click Mobile Account.

  4. On the Web Application Text Message (SMS) Service Settings page, delete entries from all the boxes, and then click OK.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft