Migrate content into or out of RBS in SharePoint 2013


Applies to: SharePoint Foundation 2013, SharePoint Server 2013

Topic Last Modified: 2016-12-16

Summary: Learn how to migrate content into or out of Remote BLOB Storage (RBS), or to a different RBS provider.

After installing RBS and setting a content database to use RBS, all existing content in that database can be migrated into the database's active provider. You use the same Windows PowerShell 3.0 command to migrate content into or out of RBS, or to another RBS provider. When RBS is implemented, SQL Server itself is regarded as an RBS provider.

You can migrate content databases at any time. But we recommend that you perform migrations during low usage periods so that this activity does not cause decrease in performance for users. Migration moves all content from the specified content database into the storage mechanism of the newly named provider.

The steps in this article apply to both SharePoint Foundation 2013 and SharePoint Server 2013, except for the Upgrade service application databases section, which applies only to SharePoint Server 2013.

Because SharePoint 2013 runs as websites in Internet Information Services (IIS), administrators and users depend on the accessibility features that browsers provide. SharePoint 2013 supports the accessibility features of supported browsers. For more information, see the following resources:

This operation can be performed on any Web server in the farm. You only have to perform the operation one time on one Web server for each content database that you want to migrate.

To migrate a content database by using Windows PowerShell
  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin.

  2. Start the SharePoint 2013 Management Shell.

    • For Windows Server 2008 R2:

      • On the Start menu, click All Programs, click Microsoft SharePoint 2013 Products, and then click SharePoint 2013 Management Shell.

    • For Windows Server 2012:

      1. On the Start screen, click SharePoint 2013 Management Shell.

        If SharePoint 2013 Management Shell is not on the Start screen:

      2. Right-click Computer, click All apps, and then click SharePoint 2013 Management Shell.

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

  3. At the Windows PowerShell command prompt, type the commands in the following steps.

  4. To obtain the content database RBS settings object:

    $rbs=(Get-SPContentDatabase <ContentDbName>).RemoteBlobStorageSettings

    Where <ContentDbName> is the name of the content database.

  5. To view a list the RBS providers installed on the Web server:

  6. To set the active RBS provider:


    Where <NewProvider> is the name of the provider that you want to make active for this content database. If you want to migrate the content database out of RBS completely and back into SQL Server inline storage, set this value to ().

  7. Migrate the data from RBS to the new provider or to SQL Server: