Get-CrmConnection

Applies To: CRM 2016 on-prem, Dynamics 365 (online), Dynamics 365 (on-premises)

Get-CrmConnection

Returns a connection to a Microsoft Dynamics 365 instance.

Syntax

Parameter Set: 
Get-CrmConnection [-ConnectionString <String> ] [ <CommonParameters>]

Parameter Set: ConnectionStringOnly
Get-CrmConnection [-MaxCrmConnectionTimeOutMinutes <Int32> ] [ <CommonParameters>]

Parameter Set: OnLine
Get-CrmConnection [-OnLineType] <CommonAuth+OnlineType> {Office365} [[-Credential] <PSCredential> ] [-DeploymentRegion] <String> -OrganizationName <String> [-LogWriteDirectory <String> ] [-MaxCrmConnectionTimeOutMinutes <Int32> ] [ <CommonParameters>]

Parameter Set: OnPrem
Get-CrmConnection [-ServerUrl] <Uri> [[-Credential] <PSCredential> ] [-OrganizationName] <String> [[-HomeRealmUrl] <Uri> ] [-LogWriteDirectory <String> ] [-MaxCrmConnectionTimeOutMinutes <Int32> ] [ <CommonParameters>]

Parameter Set: UIOnly
Get-CrmConnection [[-InteractiveMode]] [-MaxCrmConnectionTimeOutMinutes <Int32> ] [ <CommonParameters>]

Detailed Description

The Get-CrmConnection cmdlet returns a connection to a Dynamics 365 instance. Upon successful connection to Dynamics 365, it returns an initialized instance of the Microsoft.Xrm.Tooling.CrmServiceClient class.

This cmdlet applies to Microsoft Dynamics 365 (online) and Microsoft Dynamics 365 (on-premises).

Parameters

-ConnectionString<String>

Connection string used to connect to Dynamics 365.

Valid values are:

Server/Url/ServiceUri/Service Uri: URL of the Dynamics 365 server.

UserName/User Name/UserId/User Id: Identifier of the user used to connect to Dynamics 365.

Password: Password for the user.

Domain: Domain name for the user.

HomeRealmUri/Home Realm Uri: Home Realm URL used to access the delegated ADFS instance.

AuthType/AuthenticationType: Authentication type to use to connect with Dynamics 365. Default value is AD. Valid values are: AD, Live, IFD, Claims, Office365, and OAuth.

RequireNewInstance: Default value is true. Use false to reuse an instance from in-memory cache.

ClientId/AppId/ApplicationId: ID of your OAuth client app. This parameter is required when you use the OAuth authentication type.

RedirectUri/ReplyUrl: Reply URL created as part of the client Id registration. This parameter is required when you use the OAuth authentication type.

TokenCacheStorePath: Fully qualified file name to store tokens for reuse. Optional when you use the OAuth authentication type.

LoginPrompt: Allow the OAuth system to present a UI for login information. Default value is Auto. Valid values are Auto, Always, Never, and RefreshSession.

-Credential<PSCredential>

User credential for signing in to Microsoft Dynamics 365.

-LogWriteDirectory<String>

Custom directory location to store the Xrm.Tooling.Connector log files. The directory must already exist, and the user who is running the cmdlet must have Write permission to the directory. You must also use the -Verbose parameter along with the -LogWriteDirectory parameter to be able to store the log files in a custom location.

-DeploymentRegion<String>

Geographic region of your Microsoft Dynamics 365 online deployment. Valid values are NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND, and NorthAmerica2.

-HomeRealmUrl<Uri>

URI of the WS-Trust metadata endpoint.

-InteractiveMode

Enables you to use the common sign-in control dialog box to specify credentials for connecting to a Dynamics 365 instance.

-MaxCrmConnectionTimeOutMinutes<Int32>

Maximum time in minutes that Xrm.Tooling.Connector will wait for any given Dynamics 365 SDK command to complete.

-OnLineType<CommonAuth+OnlineType>

Type of online deployment. Valid values is Office365.

-OrganizationName<String>

Unique or friendly name of the Dynamics 365 organization to connect to.

-ServerUrl<Uri>

URL of the Dynamics 365 discovery server specified in the following format: http://<server>:<port>

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

• Microsoft.Xrm.Tooling.CrmServiceClient

Examples

-------------------------- EXAMPLE 1 --------------------------

Creates a connection to an on-premises instance of Microsoft Dynamics 365 using the connection string. On successful connection, it returns an initialized instance of Microsoft.Xrm.Tooling.CrmServiceClient.

PS C:\>Get-CrmConnection –ConnectionString "AuthType=AD;Url=http://mycrmserver/Contoso;Domain=mycrmserverdom;Username=user1;Password=password"

-------------------------- EXAMPLE 2 --------------------------

Creates a connection to an on-premises instance of Microsoft Dynamics 365. On successful connection, it returns an initialized instance of Microsoft.Xrm.Tooling.CrmServiceClient.

PS C:\>Get-CrmConnection -OrganizationName Contoso -ServerUrl http://mycrmserver -Credential $Cred

-------------------------- EXAMPLE 3 --------------------------

Creates a connection to an online instance of Microsoft Dynamics 365. On successful connection, it returns an initialized instance of Microsoft.Xrm.Tooling.CrmServiceClient.

PS C:\>Get-CrmConnection -OrganizationName org1 -DeploymentRegion Northamerica -OnLineType Office365 -Credential $Cred 

Related topics

Get-CrmOrganizations

Use PowerShell cmdlets for XRM tooling to connect to CRM