Share via


Add-CrmServer

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

Add-CrmServer

Adds a Microsoft Dynamics 365 server to the specified deployment.

Syntax

Parameter Set: Default
Add-CrmServer [[-Activate]] [[-CrmSqlServer] <String> ] [-Credential <PSCredential> ] [-Diag] [-DwsServerUrl <String> ] [-Timeout <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Add-CrmServer cmdlet adds a server to the Microsoft Dynamics 365 deployment, specified by CrmSqlDeploymentServer or the preconfigured deployment for this server. This is used when adding a new, prebuilt server node to an existing deployment. This cmdlet must be run from the server that’s being added to the deployment and the user identity running the cmdlet must have privileges to access the MSCRM_Config database on the Microsoft Dynamics 365 deployment host SQL Server. The DwsServerUrl and Credential parameters are ignored by this cmdlet at this time.

Parameters

-Activate

Instructs the cmdlet to activate the server as part of adding the server to the deployment. The default value is False.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Credential<PSCredential>

For internal use only.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CrmSqlServer<String>

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

true(ByValue)

Accept Wildcard Characters?

false

-Diag

Turns on stack traces for error reports returned from Microsoft Dynamics 365 service calls. Enabling this parameter displays a detailed error message, including a stack trace, when an error is encountered by the Dynamics 365 PowerShell command.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-DwsServerUrl<String>

For internal use only.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Timeout<Int32>

For internal use only.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

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

Examples

PS C:\> 
PS C:\>