Home - Esri/arcgis-powershell-dsc GitHub Wiki
Deployment Automation with PowerShell DSC ArcGIS Module
Welcome to the ArcGIS Automation using Windows PowerShell DSC project!
This repository offers a robust PowerShell DSC module and resources to automate the installation, configuration, upgrade, and patching of:
- ArcGIS Enterprise:
- Base Deployment:
- Roles:
- Extensions:
- ArcGIS Pro:
- ArcGIS License Manager
The ArcGIS Module supports a wide range of deployment patterns and ArcGIS versions across your infrastructure.
Overview
This project enables IT administrators and GIS professionals to:
- Rapidly deploy and configure ArcGIS software in a repeatable, automated manner
- Manage new deployments, patches, upgrades and ssl certificates with minimal manual intervention
- Support both single-machine and multi-machine enterprise deployments
- Leverage sample configuration files and scripts for common scenarios
Supported ArcGIS Versions:
For comprehensive information on supported ArcGIS product versions for each version of the ArcGIS Module, please refer to the Supported Versions documentation.
Getting Started
To get started with automating your ArcGIS deployments, we recommend reviewing the Quick Start Guide. This resource provides step-by-step instructions on setting up your environment, preparing configuration files, and running your first deployment. Whether you are new to PowerShell DSC or experienced with ArcGIS automation, the guide offers practical examples and best practices to help you achieve a smooth and reliable deployment process.
1. Explore Sample Workflows
Choose a workflow that matches your deployment scenario:
ArcGIS Enterprise Deployments
- Single machine base deployment
- Two machine base deployment
- Three machine base deployment
- Multi-machine base deployment
Additional ArcGIS Server Roles
- Notebook Server with Linux Containers (single machine)
- Notebook Server with Linux Containers (multi machine)
- Notebook Server with Windows Containers (single machine)
- GeoEvent Server (single machine)
- GIS Server (single machine)
- Image Server (single machine)
ArcGIS Pro
Note: All workflows require editing a JSON configuration file. Some samples can found in the SampleConfigs folder.
2. Reference Variable Documentation
Each ArcGIS Module version has its own variable reference for configuration files:
3. Additional Resources
- Scripts to push the ArcGIS Module: Automate deployment of the PowerShell module to remote machines or the PSModulePath.
- Command Line Parameters: Detailed documentation of all supported command line options for module execution.
- Use Encrypted Password Files and MOFs: Learn how to securely manage credentials using encrypted password files and MOF documents.
- Use System Environment Variables to Store Passwords: Store sensitive information such as passwords in environment variables for enhanced security.
- Download ArcGIS Installation Setups: Automate the retrieval of ArcGIS software installers directly from My Esri.
- Download and Install ArcGIS Patches: Streamline the process of downloading and applying the latest ArcGIS patches.
- Use IP Addresses Instead of Hostnames: Configure deployments to use machine IP addresses rather than fully qualified domain names.
Support & Community
- For issues, or feature requests, please use the repository’s Issues page or contact Esri Technical Support.
- For questions, please use the repository's Discussons page.
About Esri
Esri is the global leader in GIS technology, providing powerful mapping and spatial analytics solutions for organizations worldwide.