Migrate content into or out of RBS in SharePoint Server

APPLIES TO: yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

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 Microsoft PowerShell 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.

Migrate a content database

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

To migrate a content database by using Microsoft PowerShell

  1. Verify that you have the following memberships:
  • securityadmin fixed server role on the SQL Server instance.

  • db_owner fixed database role on all databases that are to be updated.

  • Administrators group on the server on which you are running the PowerShell cmdlets.

  1. Start the SharePoint Management Shell.

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

  3. To obtain the content database RBS settings object:

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

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

  1. To view a list the RBS providers installed on the Web server:
$rbs.GetProviderNames()
  1. To set the active RBS provider:
$rbs.SetActiveProviderName(<NewProvider>)

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 ().

  1. Migrate the data from RBS to the new provider or to SQL Server:
$rbs.Migrate()

See also

Concepts

Set a content database to use RBS with FILESTREAM in SharePoint Server