BeginCreateOrganizationRequest Class

  • Article

Applies To: Microsoft Dynamics CRM 2013, Microsoft Dynamics CRM Online

Contains the data that is needed to initiate the asynchronous operation to create an organization.

Namespace: Microsoft.Xrm.Sdk.Deployment
Assembly: Microsoft.Xrm.Sdk.Deployment (in Microsoft.Xrm.Sdk.Deployment.dll)

Syntax

'Declaration
<DataContractAttribute(Name:="BeginCreateOrganizationRequest", Namespace:="https://schemas.microsoft.com/xrm/2011/Contracts/Deployment")> _
<DebuggerStepThroughAttribute> _
<GeneratedCodeAttribute("System.Runtime.Serialization", "4.0.0.0")> _
Public Class BeginCreateOrganizationRequest
    Inherits DeferredOperationRequest

[DataContractAttribute(Name="BeginCreateOrganizationRequest", Namespace="https://schemas.microsoft.com/xrm/2011/Contracts/Deployment")] 
[DebuggerStepThroughAttribute] 
[GeneratedCodeAttribute("System.Runtime.Serialization", "4.0.0.0")] 
public class BeginCreateOrganizationRequest : DeferredOperationRequest

Example

Guid operationId = Guid.Empty;
            // instantiating the DeploymentServiceClient in a using statement ensures that the client
            // communication channel is closed and the object is disposed when falling out of scope.

            // CustomBinding_IDeploymenService is the name of the configuration setting for the CustomBinding
            using (DeploymentServiceClient client = new DeploymentServiceClient("CustomBinding_IDeploymentService"))
            {
                // Set properties for the new organization
                Organization organization = new Organization
                {
                    BaseCurrencyCode = "USD",
                    BaseCurrencyName = "US Dollar",
                    BaseCurrencyPrecision = 2,
                    BaseCurrencySymbol = "$",
                    BaseLanguageCode = 1033,
                    FriendlyName = "Alpine Ski House",
                    UniqueName = "AlpineSkiHouse",
                    SqlCollation = "Latin1_General_CI_AI",
                    SqlServerName = "CRM01",
                    SrsUrl = "http://CRM01/ReportServer",
                    SqmIsEnabled = false
                };

                // Create a request for the deployment service
                BeginCreateOrganizationRequest request = new BeginCreateOrganizationRequest();
                request.Organization = organization;

                // Execute the request
                BeginCreateOrganizationResponse response = (BeginCreateOrganizationResponse)client.Execute(request);

                // The operation is asynchronous, so the response object contains a unique identifier
                // for the operation
                operationId = response.OperationId;
             
            }

Remarks

Usage

Pass an instance of this class to the Execute method, which returns an instance of BeginCreateOrganizationResponse.

Notes for Callers

You can also use the New-CrmOrganizationWindows PowerShell command. For more information, see Administer the deployment using Windows PowerShel.

You can use the Get-CrmOperationStatusWindows PowerShell command to check the status of this asynchronous request. Or, you can use the RetrieveRequest message using the OperationId property to set the InstanceTag property.

Inheritance Hierarchy

System.Object
   Microsoft.Xrm.Sdk.Deployment.DeploymentServiceRequest
     Microsoft.Xrm.Sdk.Deployment.DeferredOperationRequest
      Microsoft.Xrm.Sdk.Deployment.BeginCreateOrganizationRequest

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Server 2008, Windows Server 2012, Windows 7 (All Versions), Windows 8 (All Versions)

Target Platforms

Windows 98,Windows 2000,Windows 2000 Server,Windows CE,Windows Server 2008,Windows 98 Second Edition,Pocket PC,Smart Phone,Windows Server 2003,Windows XP Professional,Windows Server 2008, ,Windows Server 2012, ,Windows 7 (All Versions), ,Windows 8 (All Versions)

Change History

See Also

Reference

BeginCreateOrganizationRequest Members
Microsoft.Xrm.Sdk.Deployment Namespace
BeginCreateOrganizationResponse

Send comments about this topic to Microsoft.
© 2013 Microsoft Corporation. All rights reserved.