Create a CRM Organization

You can create a new CRM organization in the Microsoft Dynamics CRM deployment, using the Deployment Manager or the CRM PowerShell tools. Use the following procedure to create a new tenant organization in CRM using the CRM PowerShell cmdlet.

  1. Logon to the CRM server with the Deployment Administrator role, such as CRMDEP01, as a CRM Deployment Administrator.

  2. Launch an administrative Windows PowerShell window from the quick launch bar, or from the Start menu under Program Files, Accessories, Windows PowerShell, and then Windows PowerShell.

  3. In the Windows PowerShell command window, execute the following commands:

    Add-PSSnapin Microsoft.Crm.PowerShell

  4. In the Windows PowerShell command window, execute the following command to create a CRM organization for the hosted tenant organization.

    New-CrmOrganization -DisplayName "Alpine Ski House" -SQLServerName "CRMSQL" -SrsUrl "http://CRMSQL/ReportServer" -Name "alpineskihouse" -BaseCurrencyCode "USD" -BaseCurrencyName "US Dollar" -BaseCurrencySymbol "$" -BaseCurrencyPrecision "2" -BaseLanguageCode 1033 -SqlCollation "Latin1_General_CI_AI" -SQMOptIn false

    Note

    Although the GUID of job will be returned upon successful submission of the request, the actual creation process may take a significant amount of time.

    For more details on the New-CRMOrganization cmdlet parameters, see the Deployment Manager Help contents.

    Syntax:

    New-CrmOrganization -DisplayName display_name -SQLServerName sql_server_name -SrsUrl srs_url -Name name -BaseCurrencyCode base_currency_code -BaseCurrencyName base_currency_name -BaseCurrencySymbol base_currency_symbol -BaseCurrencyPrecision base_currency_precision -BaseLanguageCode base_language_code -SqlCollation sql_collation {-SQMOptIn true|false}

    where:

  • display_name is the display name of the organization that will be imported. If no display name is provided, the default behavior is to use the existing display name in the organization's database. (mandatory)
  • sql_server_name is the name of the SQL Server database server on which to look for the organization database to import. (mandatory)
  • srs_url is the URL of the SRS reporting server for the organization that will be imported. (mandatory)
  • name is the unique name of the organization that will be imported. If no unique name is provided, the default behavior is to use a unique version of the display name. (Optional)
  • base_currency_code is the base currency code for the organization to be created, for example, "USD" for US dollar.
  • base_currency_name is the name of the base currency, for example, "US Dollar" for USD. If no base currency name is provided, the default behavior is to use a currency name based on the base_currency_code specified.
  • base_currency_symbol is the symbol of the base currency, for example, "$" for the US Dollar. If no base currency symbol is provided, the default behavior is to use a value based on the base_currency_code specified.
  • base_currency_precision is the decimal precision of the base currency, for example, two decimal places for US Dollar. If no base currency precision is provided, the default behavior is to use a value based on the base_currency_code specified.
  • base_language_code is the code for the base language for the organization being created, for example, "1033" for English.
  • sql_collation is an enumerated (enum) value that specifies the preferred SQL collation that the organization database will use to sort and compare data characters.
  • SQMOptIn specifies whether to have the organization participate in the Customer Experience Improvement Program. The default value is false.