Configure a mobile account (SharePoint Foundation 2010)

 

Applies to: SharePoint Foundation 2010

This article discusses how to configure and manage a mobile account for Microsoft SharePoint Foundation 2010 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.

The mobile alert feature resembles a feature that already exists in SharePoint Foundation 2010 that enables outgoing e-mail alerts. However, instead of receiving alerts via e-mail when changes are made in a SharePoint list or item, users receive the alerts on their mobile phones. For more information about e-mail alerts, see Configure outgoing e-mail (SharePoint Foundation 2010).

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 that:

  • 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.

Procedures in this article:

  • Import a root certificate and create a trusted root authority

  • Configure a mobile account

  • Retrieve mobile account information

  • Delete a mobile account

Import a root certificate and create a trusted root authority

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 local Administrators group on the computer running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 Management Shell.

  5. 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.

    Note

    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.

Configure a mobile account

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

Note

If you cannot configure a mobile account, you may 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 Web site.
  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 Find an Office 2010 Mobile 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 Find an Office 2010 Mobile 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 Web site of the service provider that you selected. On the Web site, 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.

    Note

    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 local Administrators group on the computer running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 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
    

    Note

    Ensure that the service URL you enter is an HTTPS URL.

For more information, see Set-SPMobileMessagingAccount 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 the SharePoint Central Administration Web site.
  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 Find an Office 2010 Mobile 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 Find an Office 2010 Mobile 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 Web site of the service provider that you selected. On the Web site, 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 in the information.

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

    Note

    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 local Administrators group on the computer running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 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 https://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 https://localhost | Set-SPMobileMessagingAccount -Identity sms -ServiceUrl https://www.example.com/omsservice.asmx -UserId someone@example.com -Password password1
    

    Note

    Ensure that the service URL you enter is an HTTPS URL.

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

Retrieve mobile account information

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, 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 local Administrators group on the computer running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 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 local Administrators group on the computer running Windows PowerShell.

  2. On the Start menu, click All Programs.

  3. Click Microsoft SharePoint 2010 Products.

  4. Click SharePoint 2010 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 https://localhost
    

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

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

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

Delete a mobile account

You can delete a mobile account for a server farm or for a Web application. This makes the account unavailable so users can no longer subscribe to SMS alerts, but 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.

Note

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 the SharePoint Central Administration Web site.
  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 the SharePoint Central Administration Web site.
  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.

See Also

Concepts

Configure outgoing e-mail (SharePoint Foundation 2010)

Other Resources

Resource Center: Installation and Deployment for SharePoint Foundation 2010