A PowerShell module for performing Dynamics 365 DevOps activities.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
samples
src
.gitattributes
.gitignore
Adoxio.Dynamics.DevOps.sln
LICENSE
README.md

README.md

Adoxio.Dynamics.DevOps

Adoxio.Dynamics.DevOps is a PowerShell module for performing DevOps activities for Dynamics 365 CE.

Installation for Dynamics 365 v9.x

  • Open Windows PowerShell and install the module from the PowerShell Gallery
    Install-Module -Name Adoxio.Dynamics.DevOps -Scope CurrentUser
  • Download and install the Dynamics 365 v9.x SDK
  • Create an environment variable named CRM_SDK_PATH and set it to the folder path of the downloaded tools. The folder path to use is the Tools folder containing the ConfigurationMigration, CoreTools, PackageDeployment, and PluginRegistration folder. This can be done in PowerShell by executing this code:
    [Environment]::SetEnvironmentVariable("CRM_SDK_PATH", "C:\Path\To\Tools", "User")
  • Restart PowerShell for the new environment variable to take effect

Installation for Dynamics 365 v8.x

Walkthrough instructions are available in the blog post Installing Adoxio.Dynamics.DevOps.

An abbreviated version is as follows:

  • Open Windows PowerShell and install the module from the PowerShell Gallery
    Install-Module -Name Adoxio.Dynamics.DevOps -Scope CurrentUser
  • Download and install the Dynamics 365 v8.x SDK
  • Create an environment variable named CRM_SDK_PATH and set it to the folder path of the extracted Dynamics 365 SDK folder on your computer. The folder path to use is the SDK folder containing the Bin, Resources, SampleCode, Schemas, Templates, and Tools folders. This can be done in PowerShell by executing this code:
    [Environment]::SetEnvironmentVariable("CRM_SDK_PATH", "C:\Path\To\SDK", "User")
  • Restart PowerShell for the new environment variable to take effect

Scripting Usage

Walkthrough instructions are available in the following blog posts:

An abbreviated version is as follows:

  • Copy and rename the samples/Advanced folder from this project to the root of your own project with the name scripts
  • Edit or create files inside the CrmConnectionParameters, ExportSettings and ImportSettings folders to describe the environments, solutions, and data that will be used during exports and imports
  • Update the parameters at the top of the Export.ps1 and Import.ps1 files to refer to the file names used in the previous step
  • Invoke the Export.ps1 and Import.ps1 scripts to execute exports and imports

Project Development

To load this project for making changes to the PowerShell module and samples, ensure that you have Git installed to obtain the source code, and Visual Studio 2017 with the PowerShell Tools for Visual Studio 2017 extension to easily view and edit the code.

  • Clone the repository using Git:
    git clone https://github.com/Adoxio/Adoxio.Dynamics.DevOps.git
  • Open the Adoxio.Dynamics.DevOps.sln solution file in Visual Studio

Project Structure

The primary folders in this repository are:

Support

Support is available by submitting issues to this GitHub project.

License

This project uses the MIT license.

Contributions

This project accepts community contributions through GitHub, following the inbound=outbound model as described in the GitHub Terms of Service:

Whenever you make a contribution to a repository containing notice of a license, you license your contribution under the same terms, and you agree that you have the right to license your contribution under those terms.

Please submit one pull request per issue so that we can easily identify and review the changes.