New-CrmInstance

Reference

Module:: Microsoft.Xrm.OnlineManagementAPI

Provisions (creates) a Dataverse environment in your Office 365 tenant.

Syntax

New-CrmInstance
   -NewInstanceInfo <NewInstance>
   [-ValidateOnly]
   [-ApiUrl] <Uri>
   [[-Credential] <PSCredential>]
   [-MaxCrmConnectionTimeOutMinutes <Int32>]

Description

The New-CrmInstance cmdlet provisions (creates) a Dataverse environment in your Office 365 tenant.

Examples

Example 1

New-CrmInstance -ApiUrl $connectionhost -NewInstanceInfo $NewCrmInstance -Credential $cred

Provisions a Dataverse environment in your Office 365 tenant from information specified in the object created by the New-CrmInstanceInfo cmdlet.

Parameters

-ApiUrl

URL of the Dataverse root service endpoint. For information about this parameter see Establish your credentials and connection.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

User credential for signing in to Dataverse. For information about this parameter see Establish your credentials and connection.

Type:	PSCredential
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxCrmConnectionTimeOutMinutes

Maximum number in minutes to wait before quitting the operation.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-NewInstanceInfo

Object created by using the New-CrmInstanceInfo cmdlet that contains the information used to provision the environment.

Type:	NewInstance
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ValidateOnly

Indicates whether to validate that an environment can be provisioned with the provided parameters or create an environment. Set 1 to validate; set 0 to create.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Inputs

Microsoft.Xrm.Services.Admin.Client.Models.NewInstance

System.Management.Automation.SwitchParameter System.Uri System.Management.Automation.PSCredential System.Int32

Outputs

System.Object

New-CrmInstanceInfo