CINXE.COM

<!DOCTYPE html><html class="hasSidebar hasPageActions hasBreadcrumb conceptual has-default-focus theme-light" lang="en-us" dir="ltr" data-authenticated="false" data-auth-status-determined="false" data-target="docs" x-ms-format-detection="none"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta property="og:title" content="Install Orchestrator" /> <meta property="og:type" content="website" /> <meta property="og:url" content="https://learn.microsoft.com/en-us/system-center/orchestrator/install?view=sc-orch-2025" /><meta property="og:description" content="Provides instructions for installing System Center - Orchestrator" /><meta property="og:image" content="https://learn.microsoft.com/en-us/media/open-graph-image.png" /> <meta property="og:image:alt" content="Microsoft Learn" /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:site" content="@MicrosoftLearn" /> <meta name="color-scheme" content="light dark"><meta name="author" content="PriskeyJeronika-MS" /> <meta name="breadcrumb_path" content="/system-center/breadcrumb/toc.json" /> <meta name="default_moniker" content="sc-orch-2025" /> <meta name="depot_name" content="SC.SystemCenterDocs" /> <meta name="description" content="Provides instructions for installing System Center - Orchestrator" /> <meta name="document_id" content="a1e2f1a2-62ee-7002-df72-19e5e99851ee" /> <meta name="document_version_independent_id" content="f2c46232-096e-1031-a246-b8f013def06c" /> <meta name="feedback_help_link_type" content="get-help-at-qna" /> <meta name="feedback_help_link_url" content="https://learn.microsoft.com/en-us/answers/tags/182/msc.html" /> <meta name="feedback_product_url" content="https://feedback.azure.com/d365community/" /> <meta name="feedback_system" content="Standard" /> <meta name="git_commit_id" content="8482a9bbb528ff713311a9514e752bd9e3fbfdf8" /> <meta name="gitcommit" content="https://github.com/MicrosoftDocs/SystemCenterDocs-pr/blob/8482a9bbb528ff713311a9514e752bd9e3fbfdf8/SystemCenterDocs/orchestrator/install.md" /> <meta name="locale" content="en-us" /> <meta name="manager" content="jsuri" /> <meta name="monikers" content="sc-orch-2016" /> <meta name="monikers" content="sc-orch-2019" /> <meta name="monikers" content="sc-orch-2022" /> <meta name="monikers" content="sc-orch-2025" /> <meta name="ms.author" content="v-gjeronika" /> <meta name="ms.custom" content="UpdateFrequency.5, intro-installation, engagement-fy23" /> <meta name="ms.date" content="12/17/2024" /> <meta name="ms.service" content="system-center" /> <meta name="ms.subservice" content="orchestrator" /> <meta name="ms.topic" content="article" /> <meta name="original_content_git_url" content="https://github.com/MicrosoftDocs/SystemCenterDocs-pr/blob/live/SystemCenterDocs/orchestrator/install.md" /> <meta name="page_type" content="conceptual" /> <meta name="pdf_url_template" content="https://learn.microsoft.com/pdfstore/en-us/SC.SystemCenterDocs/{branchName}{pdfName}" /> <meta name="schema" content="Conceptual" /> <meta name="site_name" content="Docs" /> <meta name="toc_rel" content="toc.json" /> <meta name="uhfHeaderId" content="MSDocsHeader-SystemCenter" /> <meta name="updated_at" content="2024-12-17 12:04 PM" /> <meta name="word_count" content="7779" /> <meta name="persistent_id" content="97fd9816-d831-6dae-55ae-78a3f9a3510c" /> <meta name="platform_id" content="97fd9816-d831-6dae-55ae-78a3f9a3510c" /> <meta name="cmProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/5bfc2259-d89d-4d6b-97d7-584a51208ec1" data-source="generated" /> <meta name="cmProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/7696cda6-0510-47f6-8302-71bb5d2e28cf" data-source="generated" /> <meta name="spProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/4e3dafb9-38f2-4708-bb18-eecf2c0a9843" data-source="generated" /> <meta name="spProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/69c76c32-967e-4c65-b89a-74cc527db725" data-source="generated" /> <meta name="github_feedback_content_git_url" content="https://github.com/MicrosoftDocs/SystemCenterDocs-pr/blob/live/SystemCenterDocs/orchestrator/install.md" /><link href="https://learn.microsoft.com/en-us/system-center/orchestrator/install?view=sc-orch-2025" rel="canonical"><title>Install Orchestrator | Microsoft Learn</title><link rel="stylesheet" href="/static/assets/0.4.029666293/styles/site-ltr.css"> <script id="msdocs-script"> var msDocs = {environment: { supportLevel: 'production', accessLevel: 'online', reviewFeatures: false, systemContent: true, azurePortalHostname: 'portal.azure.com', legacyHosting: false, siteName: 'learn', },data: { timeOrigin: Date.now(), contentLocale: 'en-us', contentDir: 'ltr', userLocale: 'en-us', userDir: 'ltr', pageTemplate: 'Conceptual', brand: '', context: {}, hasBinaryRating: true, feedbackHelpLinkType:'get-help-at-qna', feedbackHelpLinkUrl:'https://learn.microsoft.com/en-us/answers/tags/182/msc.html', standardFeedback: true, showFeedbackReport: false, enableTutorialFeedback: false, feedbackSystem: 'Standard', feedbackGitHubRepo: '', feedbackProductUrl: 'https://feedback.azure.com/d365community/',extendBreadcrumb: false,isEditDisplayable: false, hideViewSource: false, hasPageActions: true, hasPrintButton: true, hasBookmark: true, hasShare: true, isPermissioned: false, isPrivateUnauthorized: false,hasRecommendations: true,contributors: [{ name: "PriskeyJeronika-MS", url: "https://github.com/PriskeyJeronika-MS" },{ name: "v-regandowner", url: "https://github.com/v-regandowner" },{ name: "v-dirichards", url: "https://github.com/v-dirichards" },{ name: "msadoff", url: "https://github.com/msadoff" },{ name: "GaddalaPriskeyJeronika", url: "https://github.com/GaddalaPriskeyJeronika" },{ name: "Farha-Bano", url: "https://github.com/Farha-Bano" },{ name: "ananya-msft", url: "https://github.com/ananya-msft" },{ name: "v-pgaddala", url: "https://github.com/v-pgaddala" },{ name: "JYOTHIRMAISURI", url: "https://github.com/JYOTHIRMAISURI" },{ name: "alexbuckgit", url: "https://github.com/alexbuckgit" },{ name: "DCtheGeek", url: "https://github.com/DCtheGeek" },{ name: "v-anesh", url: "https://github.com/v-anesh" },{ name: "v-makoud", url: "https://github.com/v-makoud" },{ name: "v-maudel", url: "https://github.com/v-maudel" },{ name: "georgewallace", url: "https://github.com/georgewallace" },{ name: "rayne-wiselman", url: "https://github.com/rayne-wiselman" },{ name: "sudeepku", url: "https://github.com/sudeepku" },{ name: "Duncanma", url: "https://github.com/Duncanma" },{ name: "CFreemanwa", url: "https://github.com/CFreemanwa" },{ name: "bwren", url: "https://github.com/bwren" },{ name: "v-thepet", url: "https://github.com/v-thepet" }],}, functions:{} }; </script><script src="https://wcpstatic.microsoft.com/mscc/lib/v2/wcp-consent.js"></script> <script src="https://js.monitor.azure.com/scripts/c/ms.jsll-4.min.js"></script><script src="/static/assets/0.4.029666293/global/deprecation.js"></script><script src="/static/assets/0.4.029666293/scripts/en-us/index-docs.js"></script></head> <body lang="en-us" dir="ltr"> <div class="header-holder has-default-focus"> <a href="#main" style="z-index: 1070" class="outline-color-text visually-hidden-until-focused position-fixed inner-focus focus-visible top-0 left-0 right-0 padding-xs text-align-center has-body-background" tabindex="1">Skip to main content</a><div hidden id="cookie-consent-holder" data-test-id="cookie-consent-container"></div> <div id="unsupported-browser" style=" background-color: white; color: black; padding: 16px; border-bottom: 1px solid grey;" hidden > <div style="max-width: 800px; margin: 0 auto;"> <p style="font-size: 24px">This browser is no longer supported.</p> <p style="font-size: 16px; margin-top: 16px;">Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.</p> <div style="margin-top: 12px;"> <a href="https://go.microsoft.com/fwlink/p/?LinkID=2092881 " style=" background-color: #0078d4; border: 1px solid #0078d4; color: white; padding: 6px 12px; border-radius: 2px; display: inline-block; ">Download Microsoft Edge</a> <a href="https://learn.microsoft.com/en-us/lifecycle/faq/internet-explorer-microsoft-edge" style=" background-color: white; padding: 6px 12px; border: 1px solid #505050; color: #171717; border-radius: 2px; display: inline-block; ">More info about Internet Explorer and Microsoft Edge</a> </div> </div> </div>   <header id="ms--site-header" data-test-id="site-header-wrapper" role="banner" itemscope="itemscope" itemtype="http://schema.org/Organization"> <div id="ms--mobile-nav" class="site-header display-none-tablet padding-inline-none gap-none" data-bi-name="mobile-header" data-test-id="mobile-header"></div> <div id="ms--primary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L1-header" data-test-id="primary-header"></div> <div id="ms--secondary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L2-header" data-test-id="secondary-header"></div> </header><div id="content-header" class="content-header uhf-container has-padding has-default-focus border-bottom-none" data-bi-name="content-header"> <div class="content-header-controls margin-xxs margin-inline-sm-tablet"> <button type="button" class="contents-button button button-sm margin-right-xxs" data-bi-name="contents-expand" aria-haspopup="true" data-contents-button> <span class="icon"><span class="docon docon-menu" aria-hidden="true"></span></span> <span class="contents-expand-title">Table of contents</span> </button> <button type="button" class="ap-collapse-behavior ap-expanded button button-sm" data-bi-name="ap-collapse" aria-controls="action-panel"> <span class="icon"><span class="docon docon-exit-mode" aria-hidden="true"></span></span> <span>Exit focus mode</span> </button> </div> </div><div id="disclaimer-holder" class="has-overflow-hidden has-default-focus">  </div> </div> <div class="mainContainer uhf-container has-default-focus" data-bi-name="body"> <div class="columns has-large-gaps is-gapless-mobile "><div id="left-container" class="left-container is-hidden-mobile column is-one-third-tablet is-one-quarter-desktop"> <nav id="affixed-left-container" class="margin-top-sm-tablet position-sticky display-flex flex-direction-column" aria-label="Primary"></nav> </div> <section class="primary-holder column is-two-thirds-tablet is-three-quarters-desktop">  <div class="columns is-gapless-mobile has-large-gaps "><div id="main-column" class="column is-full is-8-desktop"> <main id="main" class="" role="main" data-bi-name="content" lang="en-us" dir="ltr"> <div id="article-header" class="background-color-body margin-top-sm-tablet margin-bottom-xs display-none-print"> <div class="display-flex align-items-center "><details id="article-header-breadcrumbs-overflow-popover" class="popover" data-for="article-header-breadcrumbs"> <summary class="button button-clear button-primary button-sm inner-focus" aria-label="All breadcrumbs"> <span class="icon"> <span class="docon docon-more"></span> </span> </summary> <div id="article-header-breadcrumbs-overflow" class="popover-content padding-none"> </div> </details> <bread-crumbs id="article-header-breadcrumbs" data-test-id="article-header-breadcrumbs" class="overflow-hidden flex-grow-1 margin-right-sm margin-right-md-tablet margin-right-lg-desktop margin-left-negative-xxs padding-left-xxs"></bread-crumbs><div id="article-header-page-actions" class="opacity-none margin-left-auto display-flex flex-wrap-no-wrap align-items-stretch"><a id="lang-link-tablet" class="button button-primary button-clear button-sm display-none display-inline-flex-tablet" title="Read in English" data-bi-name="language-toggle" data-read-in-link hidden> <span class="icon margin-none" aria-hidden="true" data-read-in-link-icon> <span class="docon docon-locale-globe"></span> </span> <span class="is-visually-hidden" data-read-in-link-text>Read in English</span> </a><button type="button" class="collection button button-clear button-sm button-primary display-none display-inline-flex-tablet" data-list-type="collection" data-bi-name="collection" title="Add to collection"> <span class="icon margin-none" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="collection-status is-visually-hidden">Save</span> </button><a data-contenteditbtn class="button button-clear button-sm text-decoration-none button-primary display-none display-inline-flex-tablet" aria-label="Edit" title="Edit This Document" data-bi-name="edit" hidden href="https://github.com/MicrosoftDocs/SystemCenterDocs-pr/blob/live/SystemCenterDocs/orchestrator/install.md"> <span class="icon margin-none" aria-hidden="true"> <span class="docon docon-edit-outline"></span> </span> </a> <details class="popover popover-right" id="article-header-page-actions-overflow"> <summary class="justify-content-flex-start button button-clear button-sm button-primary" aria-label="More actions" title="More actions"> <span class="icon" aria-hidden="true"> <span class="docon docon-more-vertical"></span> </span> </summary> <div class="popover-content padding-xs"><button data-page-action-item="overflow-mobile" type="button" class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear display-none-tablet" data-bi-name="contents-expand" data-contents-button data-popover-close> <span class="icon"> <span class="docon docon-editor-list-bullet" aria-hidden="true"></span> </span><span class="contents-expand-title">Table of contents</span></button><a id="lang-link-overflow" class="justify-content-flex-start button-sm has-inner-focus button button-clear button-block display-none-tablet" title="Read in English" data-bi-name="language-toggle" data-page-action-item="overflow-mobile" data-check-hidden="true" data-read-in-link hidden > <span class="icon" aria-hidden="true" data-read-in-link-icon> <span class="docon docon-locale-globe"></span> </span> <span data-read-in-link-text>Read in English</span> </a><button type="button" class="collection justify-content-flex-start button button-clear button-sm has-inner-focus button-block display-none-tablet" data-list-type="collection" data-bi-name="collection" title="Save" data-page-action-item="overflow-mobile" data-check-hidden="true" data-popover-close> <span class="icon" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="collection-status">Save</span> </button> <button type="button" class="collection justify-content-flex-start button button-clear button-sm has-inner-focus button-block display-none-tablet" data-list-type="plan" data-bi-name="plan" title="Add to plan" data-page-action-item="overflow-mobile" data-check-hidden="true" data-popover-close hidden> <span class="icon" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="plan-status">Add to plan</span> </button><a data-contenteditbtn class="button button-clear button-block button-sm has-inner-focus justify-content-flex-start text-decoration-none display-none-tablet" aria-label="Edit" title="Edit This Document" data-bi-name="edit" hidden href="https://github.com/MicrosoftDocs/SystemCenterDocs-pr/blob/live/SystemCenterDocs/orchestrator/install.md"> <span class="icon" aria-hidden="true"> <span class="docon docon-edit-outline"></span> </span> <span>Edit</span> </a><div aria-hidden="true" class="margin-none" data-page-action-item="overflow-all"></div> <hr class="display-none-tablet margin-bottom-xxs margin-top-xxs" /> <h4 class="font-size-sm padding-left-xxs">Share via</h4> <a class="button button-clear button-sm button-block has-inner-focus text-decoration-none justify-content-flex-start share-facebook" data-bi-name="facebook" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-facebook-share font-size-md color-primary"></span> </span> <span class="margin-left-xxs">Facebook</span> </a> <a class="button button-clear button-sm has-inner-focus button-block text-decoration-none justify-content-flex-start share-twitter" data-bi-name="twitter" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-xlogo-share font-size-xxs"></span> </span> <span class="margin-left-xxs">x.com</span> </a> <a class="button button-clear button-sm has-inner-focus button-block text-decoration-none justify-content-flex-start share-linkedin" data-bi-name="linkedin" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-linked-in-logo font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">LinkedIn</span> </a> <a class="button button-clear button-sm button-block has-inner-focus text-decoration-none justify-content-flex-start margin-bottom-xxs share-email" data-bi-name="email" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-mail-message font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">Email</span> </a><hr /> <button class="button button-block button-clear button-sm justify-content-flex-start has-inner-focus margin-top-xxs" title="Print" type="button" aria-label="Print" data-bi-name="print" data-page-action-item="overflow-all" data-popover-close data-print-page data-check-hidden="true"> <span class="icon" aria-hidden="true"> <span class="docon docon-print font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">Print</span> </button> </div> </details> </div></div> </div> <div> <button type="button" class="border contents-button button button-clear button-sm is-hidden-tablet has-inner-focus" data-bi-name="contents-expand" data-contents-button hidden> <span class="icon"> <span class="docon docon-editor-list-bullet" aria-hidden="true"></span> </span><span class="contents-expand-title">Table of contents</span></button> </div> <div class="content "><h1 id="install-system-center---orchestrator">Install System Center - Orchestrator</h1><div class="display-flex justify-content-space-between align-items-center flex-wrap-wrap page-metadata-container"> <div class="margin-right-xxs"> <ul class="metadata page-metadata" data-bi-name="page info" lang="en-us" dir="ltr"><li>Article</li><li class="visibility-hidden-visual-diff"><time class="is-invisible" data-article-date aria-label="Article review date" datetime="2024-12-17T08:00:00Z" data-article-date-source="calculated">12/17/2024</time> </li><li class="contributors-holder display-none-print"> <button type="button" class="contributors-button link-button" data-bi-name="contributors">21 contributors</button> </li></ul> </div> <div id="user-feedback" class="margin-block-xxs display-none-print" data-hide-on-archived> <button id="user-feedback-button" data-test-id="conceptual-feedback-button" class="button button-sm button-clear button-primary" type="button" data-bi-name="user-feedback-button" data-user-feedback-button > <span class="icon" aria-hidden="true"> <span class="docon docon-like"></span> </span> <span>Feedback</span> </button> </div></div><nav id="center-doc-outline" class="doc-outline is-hidden-desktop display-none-print margin-bottom-sm" data-bi-name="intopic toc" aria-label="In this article"> <h2 id="ms--in-this-article" class="title is-6 margin-block-xs">In this article</h2> </nav><div data-moniker="sc-orch-2022 sc-orch-2025"> <p>A complete Orchestrator installation includes:</p> <ul> <li>a management server</li> <li>one or more runbook servers</li> <li>a SQL Server for hosting the Orchestrator database</li> <li>a web server for hosting the Orchestrator web API service</li> <li>a server for hosting the Runbook Designer and Runbook Tester</li> <li>a web server for hosting the Orchestration Console</li> </ul> <p>It's possible to install all these roles and components on a single computer, but it's more common to distribute the roles across several computers or virtual machines.</p> <p>For a detailed description of the Orchestrator architecture, see <a href="learn-about-orchestrator?view=sc-orch-2025" data-linktype="relative-path">Learn about Orchestrator</a>.</p> <p>To know about the prerequisites, see <a href="system-requirements-orch?view=sc-orch-2025" data-linktype="relative-path">System requirements for System Center Orchestrator</a>.</p> <p>This article provides detailed installation instructions for the various Orchestrator roles.</p> <div class="NOTE"> <p>Note</p> <p>Install the <a href="/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022&preserve-view=true" data-linktype="absolute-path">Microsoft Visual C++ Redistributable</a> package before running the Setup executable (SetupOrchestrator.exe).</p> </div> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <p>A complete Orchestrator installation includes a management server, one or more runbook servers, a SQL Server for hosting the Orchestrator database, a web server for hosting the Orchestrator web service, and a server for hosting the Runbook Designer and Runbook Tester. It's possible to install all these roles on a single computer, but it's more common to distribute the roles across several computers or virtual machines.</p> <p>For a detailed description of the Orchestrator architecture, see <a href="learn-about-orchestrator?view=sc-orch-2025" data-linktype="relative-path">Learn about Orchestrator</a>.</p> <p>This article provides detailed installation instructions for the various Orchestrator roles.</p> </div> <h2 id="install-an-orchestrator-management-server">Install an Orchestrator management server</h2> <div data-moniker="sc-orch-2022 sc-orch-2025"> <ol> <li><p>On the server where you want to install the Orchestrator, install the <a href="/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022&preserve-view=true" data-linktype="absolute-path">Microsoft Visual C++ Redistributable</a> package and start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="IMPORTANT"> <p>Important</p> <p>Before you begin setup, close any open programs, and ensure that there are no pending restarts on the computer. For example, if you've installed a server role by using System Center - Service Manager or have applied a security update, you might have to restart the computer, and then sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> <div class="NOTE"> <p>Note</p> <p>If User Account Control is enabled, you will be prompted to verify that you want to allow the setup program to run. This is because it requires administrative access to make changes to the system.</p> </div> </li> <li><p>On the main page of the wizard, select <strong>Install</strong>.</p> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice and then select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select features to install</strong> page, ensure that <strong>Management Server</strong> is the only feature selected and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for required hardware and software. If your computer meets all the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> </li> </ol> <p>If a prerequisite isn't met, a page displays the information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> <div class="WARNING"> <p>Warning</p> <p>If you enable prerequisites during setup, such as Microsoft .NET Framework 4, your computer can require a restart. If you restart your computer, you must run setup again from the beginning.</p> </div> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> <li><p>On the <strong>Configure the service account</strong> page, enter the username and password for the Orchestrator service account. Select <strong>Test</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> </ol> </div> <div data-moniker="sc-orch-2022"> <ol start="5"> <li>On the <strong>Configure the database server</strong> page, enter the name of the server and the name of the instance of Microsoft SQL Server that you want to use for Orchestrator. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</li> </ol> </div> <div data-moniker="sc-orch-2025"> <ol start="5"> <li>On the <strong>Configure the database server</strong> page, enter the name of the server and the name of the instance of Microsoft SQL Server that you want to use for Orchestrator. Connection with SQL server is encrypted by default. You must install a certificate that client can trust or you can follow the <a href="#secure-connection-to-sql-server" data-linktype="self-bookmark">Secure Connection to SQL server</a> to bypass the recommended trust mechanism. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</li> </ol> </div> <div data-moniker="sc-orch-2022 sc-orch-2025"> <ol start="6"> <li><p>On the <strong>Configure the database</strong> page, select a database or create a new database, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure Orchestrator users group</strong> page, accept the default configuration or enter the name of the Active Directory user group to manage Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator and change it if you want to, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <ol> <li><p>On the server where you want to install Orchestrator, start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="IMPORTANT"> <p>Important</p> <p>Before you begin setup, close any open programs and ensure that there are no pending restarts on the computer. For example, if you've installed a server role by using System Center - Service Manager or have applied a security update, you might have to restart the computer, and then sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> <div class="NOTE"> <p>Note</p> <p>If User Account Control is enabled, then you will be prompted to verify that you want to allow the setup program to run. This is because it requires administrative access to make changes to the system.</p> </div> </li> <li><p>On the main page of the wizard, select <strong>Install</strong>.</p> <div class="WARNING"> <p>Warning</p> <p>If Microsoft .NET Framework 3.5 Service Pack 1 isn't installed on your computer, a dialog appears asking if you want to install .NET Framework 3.5 SP1. Select <strong>Yes</strong> to proceed with the installation.</p> </div> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select features to install</strong> page, ensure that <strong>Management Server</strong> is the only feature selected, and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for required hardware and software. If your computer meets all of the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> </li> </ol> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> <div class="WARNING"> <p>Warning</p> <p>If you enable prerequisites during setup, such as Microsoft .NET Framework 4, your computer can require a restart. If you restart your computer, you must run setup again from the beginning.</p> </div> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> <li><p>On the <strong>Configure the service account</strong> page, enter the user name and password for the Orchestrator service account. Select <strong>Test</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the database server</strong> page, enter the name of the server and the name of the instance of Microsoft SQL Server that you want to use for Orchestrator. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the database</strong> page, select a database or create a new database, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure Orchestrator users group</strong> page, accept the default configuration or enter the name of the Active Directory user group to manage Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator and change it if you want to, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> </div> <h2 id="install-orchestrator-runbook-server">Install Orchestrator runbook server</h2> <div data-moniker="sc-orch-2022 sc-orch-2025"> <ol> <li><p>On the server where you want to install the Orchestrator runbook server, install the <a href="/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022&preserve-view=true" data-linktype="absolute-path">Microsoft Visual C++ Redistributable</a> package and start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="NOTE"> <p>Note</p> <p>Before you begin setup, close any open programs, and ensure that there are no pending restarts on the computer. For example, if you have installed a server role by using System Center - Service Manager or have applied a security update, you might have to restart the computer, and then sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> </li> <li><p>On the main setup page, under <strong>Standalone installations</strong>, select <strong>Runbook server</strong>.</p> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for the required hardware and software. If your computer meets all the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> <div class="WARNING"> <p>Warning</p> <p>If you enable prerequisites during setup, such as Microsoft .NET Framework 4, your computer may require a restart. If you restart your computer, you must run setup again from the beginning.</p> </div> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> </ol> </li> <li><p>On the <strong>Configure the service account</strong> page, enter the username and password for the Orchestrator service account. Select <strong>Test</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> </ol> </div> <div data-moniker="sc-orch-2022"> <ol start="7"> <li>On the <strong>Configure the database server</strong> page, enter the name of the database server associated with your Orchestrator management server. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</li> </ol> </div> <div data-moniker="sc-orch-2025"> <ol start="7"> <li>On the <strong>Configure the database server</strong> page, enter the name of the database server associated with your Orchestrator management server. Connection with SQL server is encrypted by default. You must install a certificate that client can trust or you can follow the <a href="#secure-connection-to-sql-server" data-linktype="self-bookmark">Secure Connection to SQL server</a> to bypass the recommended trust mechanism. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</li> </ol> </div> <div data-moniker="sc-orch-2022 sc-orch-2025"> <ol start="8"> <li><p>On the <strong>Configure the database</strong> page, select the Orchestrator database for your deployment, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start the Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <ol> <li><p>On the server where you want to install an Orchestrator runbook server, start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="NOTE"> <p>Note</p> <p>Before you begin setup, close any open programs and ensure that there are no pending restarts on the computer. For example, if you've installed a server role by using System Center - Service Manager or have applied a security update, you might have to restart the computer, and then sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> </li> <li><p>On the main setup page, under <strong>Standalone installations</strong>, select <strong>Runbook server</strong>.</p> <div class="WARNING"> <p>Warning</p> <p>If Microsoft .NET Framework 3.5 Service Pack 1 isn't installed on your computer, a dialog appears asking whether you want to install .NET Framework 3.5 SP1. Select <strong>Yes</strong> to proceed with the installation.</p> </div> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice, and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for required hardware and software. If your computer meets all of the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> </li> </ol> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> <div class="WARNING"> <p>Warning</p> <p>If you enable prerequisites during setup, such as Microsoft .NET Framework 4, your computer can require a restart. If you restart your computer, you must run setup again from the beginning.</p> </div> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> <li><p>On the <strong>Configure the service account</strong> page, enter the user name and password for the Orchestrator service account. Select <strong>Test</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the database server</strong> page, enter the name of the database server associated with your Orchestrator management server. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the database</strong> page, select the Orchestrator database for your deployment, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start the Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> </div> <h2 id="install-orchestrator-web-api-service">Install Orchestrator Web API service</h2> <div data-moniker="sc-orch-2022 sc-orch-2025"> <p>Since Orchestrator 2022, the Web API service and Orchestration Console can be installed separately on different machines.</p> <ol> <li><p>On the server where you want to install the Orchestrator web API, install the <a href="/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022&preserve-view=true" data-linktype="absolute-path">Microsoft Visual C++ Redistributable</a> package and start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="NOTE"> <p>Note</p> <p>Before you begin the installation of the Orchestrator Web API service, close any open programs, and ensure that there're no pending restarts on the computer. Then sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> </li> <li><p>On the main setup page, under <strong>Standalone installations</strong>, select <strong>Web API Service</strong>.</p> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice, and select <strong>Next</strong>.</p> </li> </ol> </div> <div data-moniker="sc-orch-2022"> <ol start="5"> <li><p>Your computer is checked for required the hardware and software. If your computer meets all the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. The Web API requires .NET Hosting bundle v5.x and some IIS extensions. Download and install them from the official sites:</p> <ul> <li>.NET Hosting bundle</li> <li>IIS CORS (Cross-Origin Resource Sharing) module</li> </ul> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> </ol> </li> </ol> </div> <div data-moniker="sc-orch-2025"> <ol start="5"> <li><p>Your computer is checked for required the hardware and software. If your computer meets all the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. The Web API requires .NET Hosting bundle v8.x and some IIS extensions. Download and install them from the official sites:</p> <ul> <li>.NET Hosting bundle</li> <li>IIS CORS (Cross-Origin Resource Sharing) module</li> </ul> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> </ol> </li> </ol> </div> <div data-moniker="sc-orch-2022 sc-orch-2025"> <ol start="6"> <li><p>On the <strong>Configure the service account</strong> page, enter the username and password for the Orchestrator service account. The Web API runs under an IIS App Pool with this identity. Select <strong>Test</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>If the service account you enter here is not a member of the local Administrators group, you must grant the user permissions in the IIS Metabase. To do this, open an administrative command window, navigate to the directory <strong>C:\Windows\Microsoft.NET\Framework64\v4.0.30319</strong> and run the below command. Replace DOMAIN\USER with the domain and username of the service account.</p> <pre><code>aspnet_regiis.exe -ga DOMAIN\USER </code></pre> </div> </li> </ol> </div> <div data-moniker="sc-orch-2022"> <ol start="7"> <li>On the <strong>Configure the database server</strong> page, enter the name of the database server associated with your Orchestrator management server. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. If Windows Authentication is selected, the service account credentials from previous steps are used to connect to the database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</li> </ol> </div> <div data-moniker="sc-orch-2025"> <ol start="7"> <li>On the <strong>Configure the database server</strong> page, enter the name of the database server associated with your Orchestrator management server. Connection with SQL server is encrypted by default. You must install a certificate that client can trust or you can follow the <a href="#secure-connection-to-sql-server" data-linktype="self-bookmark">Secure Connection to SQL server</a> to bypass the recommended trust mechanism. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. If Windows Authentication is selected, the service account credentials from previous steps are used to connect to the database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</li> </ol> </div> <div data-moniker="sc-orch-2022 sc-orch-2025"> <ol start="8"> <li><p>On the <strong>Configure the database</strong> page, select the Orchestrator database for your deployment, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure CORS (Cross-Origin Resource Sharing) and the port for the Web API</strong> page, verify the port numbers for the Orchestrator Web API service and the URL of the Orchestration console, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> </li> </ol> <p><a href="#configure-your-installation" data-linktype="self-bookmark">Learn</a> how to configure the API after installation.</p> </div> <div data-moniker="sc-orch-2025"> <div class="NOTE"> <p>Note</p> <p>The setup tries to enable some IIS features, this fails if those features are already enabled. This is true for machines where (even previous version of) Orchestrator Web API was previously installed. You can check this in the Setup logs on <code>%AppData%\Local\Microsoft System Center 2012\Orchestrator\LOGS\*.log</code> where you’ll see the error about IIS features. To skip this step, run Setup.exe from the command prompt.</p> </div> </div> <div data-moniker="sc-orch-2022 sc-orch-2025"> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <ol> <li><p>On the server where you want to install the Orchestrator web service, start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="NOTE"> <p>Note</p> <p>Before you begin the installation of the Orchestrator web service, close any open programs and ensure that there are no pending restarts on the computer. Then sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> </li> <li><p>On the main setup page, under <strong>Standalone installations</strong>, select <strong>Orchestration Console and Web Service</strong>.</p> <div class="WARNING"> <p>Warning</p> <p>If Microsoft .NET Framework 3.5 Service Pack 1 isn't installed on your computer, a dialog appears asking if you want to install .NET Framework 3.5 SP1. Select <strong>Yes</strong> to proceed with the installation.</p> </div> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice, and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for required hardware and software. If your computer meets all of the requirements, the <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> <div class="WARNING"> <p>Warning</p> <p>If you enable prerequisites during setup, such as Microsoft .NET Framework 4, your computer can require a restart. If you restart your computer, you must run setup again from the beginning.</p> </div> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> </ol> </li> <li><p>On the <strong>Configure the service account</strong> page, enter the user name and password for the Orchestrator service account. Select <strong>Test</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the database server</strong> page, enter the name of the database server associated with your Orchestrator management server. You can also specify whether to use Windows Authentication or SQL Server Authentication, and whether to create a new database or use an existing database. Select <strong>Test Database Connection</strong> to verify the account credentials. If the credentials are accepted, select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the database</strong> page, select the Orchestrator database for your deployment, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Configure the port for the web service</strong> page, verify the port numbers for the Orchestrator web service and the Orchestration console, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start the Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> </div> <div data-moniker="sc-orch-2022 sc-orch-2025"> <h2 id="install-orchestration-console">Install Orchestration Console</h2> <p>Since Orchestrator 2022, the Web API service and Orchestration Console can be installed separately on different machines.</p> <ol> <li><p>On the server where you want to install the Orchestration Console, install the <a href="/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022&preserve-view=true" data-linktype="absolute-path">Microsoft Visual C++ Redistributable</a> package and start the Orchestrator Setup Wizard. To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> </li> <li><p>On the main <strong>Setup</strong> page, under <strong>Standalone installations</strong>, select <strong>Orchestration Console</strong>.</p> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review, and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice, and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for required hardware and software. If your computer meets all the requirements, <strong>All prerequisites are installed</strong> page appears. Select <strong>Next</strong> and proceed to the next step.</p> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <p>Orchestration Console requires IIS URL Rewrite module; download from here.</p> </li> <li><p>On the <strong>Configure the service account</strong> page, enter the username and password for the Orchestrator service account. The Console runs under an IIS App Pool with this identity. Select <strong>Test to verify the account credentials</strong>. If the credentials are accepted, select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>If the service account you enter here is not a member of the local Administrators group, you must grant the user permissions in the IIS Metabase. To do this, open an administrative command window, navigate to the directory <strong>C:\Windows\Microsoft.NET\Framework64\v4.0.30319</strong> and run the below command. Replace DOMAIN\USER with the domain and username of the service account.</p> <pre><code>aspnet_regiis.exe -ga DOMAIN\USER </code></pre> </div> </li> <li><p>On the <strong>Configure the ports for the Web Console</strong> page, verify the port numbers for the Orchestration Console service and the URL of the Web API service, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>The Web API URL should not have a trailing forward slash <code>/</code>.</p> </div> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in Error Reporting, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page and select <strong>Install</strong>.</p> </li> </ol> <p><a href="#configure-your-installation" data-linktype="self-bookmark">Learn</a> how to configure the Console after installation.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <h2 id="install-the-orchestrator-runbook-designer-on-a-single-computer">Install the Orchestrator Runbook Designer on a single computer</h2> <ol> <li><p>On the server where you want to install the Orchestrator Runbook Designer, start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="NOTE"> <p>Note</p> <p>Before you begin the install of the Runbook Designer, close any open programs and ensure that there are no pending restarts on the computer. Then, sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> </li> <li><p>On the main wizard page, select <strong>Runbook Designer</strong>.</p> <div class="WARNING"> <p>Warning</p> <p>If Microsoft .NET Framework 3.5 Service Pack 1 isn't installed on your computer, a dialog appears asking if you want to install .NET Framework 3.5 SP1. Select <strong>Yes</strong> to proceed with the installation.</p> </div> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice, and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for required hardware and software. If your computer meets all of the requirements, proceed to the next step.</p> </li> </ol> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator and change it if you want to, and select</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start the Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> </div> <h2 id="connect-a-runbook-designer-to-a-management-server">Connect a Runbook Designer to a management server</h2> <ol> <li><p>In the Runbook Designer, select the <strong>Connect to a server</strong> icon in the navigation pane under the <strong>Connections</strong> pane.</p> <div class="NOTE"> <p>Note</p> <p>If the Runbook Designer is connected to another management server, the <strong>Connect to a server</strong> icon is disabled. Select the <strong>Disconnect</strong> icon before you connect to a different management server.</p> </div> </li> <li><p>In <strong>System Center Orchestrator Connection</strong>, enter the name of the server that hosts your Orchestrator management server, and select <strong>OK</strong>.</p> </li> </ol> <h2 id="enable-network-discovery">Enable network discovery</h2> <ol> <li><p>On the desktop of your computer running Windows server, select <strong>Start</strong>, select <strong>Control Panel</strong>, select <strong>Network and Internet</strong>, select <strong>Network and Sharing Center</strong>, select <strong>Choose Home group and Sharing Options</strong>, and select <strong>Change advanced sharing settings</strong>.</p> </li> <li><p>To change the <strong>Domain</strong> profile, if needed, select the <strong>Arrow</strong> icon to expand the section options and make any necessary changes.</p> </li> <li><p>Select <strong>Turn on network discovery</strong>, and select <strong>Save changes</strong>.</p> <p>If you're prompted for an administrator password or confirmation, enter the password or provide confirmation.</p> </li> </ol> <div data-moniker="sc-orch-2025"> <h2 id="secure-connection-to-sql-server">Secure connection to SQL server</h2> <p>Due to breaking changes in EFCore 8 and OLEDB 19, SQL Server connection is encrypted by default and requires a certificate that client can trust which means:</p> <ul> <li>The SQL Server must be configured with a valid certificate</li> <li>The client must trust this certificate</li> </ul> <p>If these conditions aren't met, then a SqlException is thrown. For example:</p> <p>A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 - The certificate chain was issued by an authority that is not trusted.)</p> <p>Following are the three ways to mitigate this error:</p> <ul> <li><p>Option 1: <a href="/en-us/sql/database-engine/configure-windows/configure-sql-server-encryption?view=sql-server-ver16" data-linktype="absolute-path">Install a valid certificate on a server</a>.</p> <div class="NOTE"> <p>Note</p> <p>It is recommended to obtain a certificate and ensure it is signed by an authority trusted by the client.</p> </div> </li> <li><p>Option 2: <code>TrustServerCertificate=True</code> to allow bypassing the normal trust mechanism (not recommended). For more information, see <a href="/en-us/sql/connect/oledb/features/encryption-and-certificate-validation?view=sql-server-ver16#encryption-and-certificate-validation-behavior" data-linktype="absolute-path">How encryption and certificate validation works</a>.</p> <ol> <li><p>Set registry setting for Trust Server Certificate to <strong>True</strong> (Set this flag Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSSQLServer\Client\SNI19.0\GeneralFlags\Flag2). <a href="/en-us/sql/connect/oledb/features/registry-settings?view=sql-server-ver16#trust-server-certificate" data-linktype="absolute-path">Learn more</a>.</p> </li> <li><p>During installation, check the checkbox <strong>Yes, Trust Server Certificate (not recommended)</strong>. Following configuration occurs:</p> <ol> <li>For SQL Connection string, adds <em>Trust Server Certificate=true</em>.</li> <li>In webapi.config, adds <environmentVariable name="Database__TrustServerCertificate" value="true"/></li> </ol> <p><span class="mx-imgBorder"> <img src="media/install/configuration.png?view=sc-orch-2025" alt="Screenshot showing configuration screen." data-linktype="relative-path"> </span> </p> <p>Alternatively, On the <strong>Data Store Configuration</strong> page, in <strong>Server</strong>, enter <code>localhost;Trust Server Certificate=True</code> and this results in the following:</p> <p><span class="mx-imgBorder"> <img src="media/install/server-details.png?view=sc-orch-2025" alt="Screenshot showing server details." data-linktype="relative-path"> </span> </p> </li> </ol> </li> <li><p>Option 3: Use Data Store configuration to explicitly set <em>Server = localhost;Use encryption for Data=False</em> to the connection string (not recommended) to not encrypt the connection.</p> </li> </ul> <div class="WARNING"> <p>Warning</p> <p>Options 2 and 3 both leave the server in a potentially insecure state.</p> </div> </div> <h2 id="install-orchestrator-runbook-designer">Install Orchestrator Runbook Designer</h2> <ol> <li><p>On the server where you want to install the Orchestrator Runbook Designer, install the <a href="/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022&preserve-view=true" data-linktype="absolute-path">Microsoft Visual C++ Redistributable</a> package and start the Orchestrator Setup Wizard.</p> <p>To start the wizard on your product media or network share, double-click <strong>SetupOrchestrator.exe</strong>.</p> <div class="NOTE"> <p>Note</p> <p>Before you begin the install of the Runbook Designer, close any open programs, and ensure that there are no pending restarts on the computer. Then, sign in to the computer with the same user account to finish the installation of the server role or the security update.</p> </div> </li> <li><p>On the main wizard page, select <strong>Runbook Designer</strong>.</p> </li> <li><p>On the <strong>Product registration</strong> page, provide the name and company for the product registration, and select <strong>Next</strong>.</p> <div class="NOTE"> <p>Note</p> <p>For this evaluation release, a product key isn't required.</p> </div> </li> <li><p>On the <strong>Please read this License Terms</strong> page, review, and accept the Microsoft Software License Terms, and select <strong>Next</strong>.</p> <p>On the <strong>Diagnostic and Usage data</strong> page, review the Diagnostic and Usage data notice and select <strong>Next</strong>.</p> </li> <li><p>Your computer is checked for the required hardware and software. If your computer meets all the requirements, proceed to the next step.</p> <p>If a prerequisite isn't met, a page displays information about the prerequisite that hasn't been met and how to resolve the issue. Use the following steps to resolve the failed prerequisite check:</p> <ol> <li><p>Review the items that didn't pass the prerequisite check. For some requirements, such as Microsoft .NET Framework 4, you can use the link provided in the Setup Wizard to install the missing requirement. The Setup Wizard can install or configure other prerequisites, such as the Internet Information Services (IIS) role.</p> </li> <li><p>After you resolve the missing prerequisites, select <strong>Verify prerequisites again</strong>.</p> </li> <li><p>Select <strong>Next</strong> to continue.</p> </li> </ol> </li> <li><p>On the <strong>Select the installation location</strong> page, verify the installation location for Orchestrator and change it if you want to, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Microsoft Update</strong> page, optionally indicate whether you want to use the Microsoft Update services to check for updates, and select <strong>Next</strong>.</p> </li> <li><p>On the <strong>Help improve Microsoft System Center Orchestrator</strong> page, optionally indicate whether you want to participate in <strong>Error Reporting</strong>, and select <strong>Next</strong>.</p> </li> <li><p>Review the <strong>Installation summary</strong> page, and select <strong>Install</strong>.</p> <p>The <strong>Installing features</strong> page appears and displays the installation progress.</p> </li> <li><p>On the <strong>Setup completed successfully</strong> page, optionally indicate whether you want to start the Runbook Designer, and select <strong>Close</strong> to complete the installation.</p> </li> </ol> <h2 id="install-from-the-command-prompt">Install from the command prompt</h2> <p>To install Orchestrator at a command prompt, use Setup.exe with the command-line options in the following table.</p> <div data-moniker="sc-orch-2016 sc-orch-2019 sc-orch-2022"> <table> <thead> <tr> <th>Option</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>/Silent</td> <td>Installation is performed without displaying a dialog.</td> </tr> <tr> <td>/Uninstall</td> <td>Product is uninstalled. This option is performed silently.</td> </tr> <tr> <td>/Key:[Product Key]</td> <td>Specifies the product key. If no product key is specified, Orchestrator is installed as an evaluation edition.</td> </tr> <tr> <td>/ServiceUserName:[UserName]</td> <td>Specifies the user account for the Orchestrator Management Service. This value is required if you're installing Management Server, Runbook Server, or web services.</td> </tr> <tr> <td>/ServicePassword:[Password]</td> <td>Specifies the password for the user account for the Orchestrator Management Service. This value is required if you're installing Management Server, Runbook Server, or web services.</td> </tr> <tr> <td>/Components:[Feature 1, Feature 2,"]</td> <td>Specifies the features to install (comma separated). Possible values are ManagementServer, RunbookServer, RunbookDesigner, WebAPI, WebConsole and All.</td> </tr> <tr> <td>/InstallDir:[Path]</td> <td>Specifies the path to install Orchestrator. If no path is specified, C:\Program Files\Microsoft System Center<version>\Orchestrator is used.</td> </tr> <tr> <td>/DbServer:[Computer[\Instance]]</td> <td>Specifies the computer name and instance of the database server. This value is required if you're installing Management Server, Runbook Server, or web services.</td> </tr> <tr> <td>/DbUser:[UserName]</td> <td>Specifies the user account to access the database server. This value is only required for SQL Authentication. If Windows Authentication is used, no value should be specified.</td> </tr> <tr> <td>/DbPassword:[Password]</td> <td>Specifies the password for the user account to access the database server. This value is only required for SQL Authentication. If Windows Authentication is used, then no value should be specified.</td> </tr> <tr> <td>/DbNameNew:[Database Name]</td> <td>Specifies the database name if a new database is being created. Can't be used with DbNameExisting.</td> </tr> <tr> <td>/DbNameExisting:[Database Name]</td> <td>Specifies the database name if an existing database is being used. Can't be used with DbNameNew.</td> </tr> <tr> <td>/WebServicePort:[Port]</td> <td>Specifies the port to use for the Web API service. Required if Web API service is installed.</td> </tr> <tr> <td>/WebConsolePublicUrl: [URL]</td> <td>Specifies the URL of the Orchestration Console that should be used to configure CORS on the Web API. Required if Web API service is installed.</td> </tr> <tr> <td>/WebConsolePort:[Port]</td> <td>Specifies the port to use for the Orchestrator console. Required if Orchestrator Console is installed.</td> </tr> <tr> <td>/WebServicePublicUrl:[URL]</td> <td>Specifies the URL of the web API service that should be used by the Orchestration Console. Required if Orchestration Console is installed.</td> </tr> <tr> <td>/OrchestratorUsersGroup:[Group SID]</td> <td>Specifies the SID of the domain or local group that will be granted access to Management server. If no value is specified, the default local group is used.</td> </tr> <tr> <td>/OrchestratorRemote</td> <td>Specifies that remote access should be granted to the Runbook Designer.</td> </tr> <tr> <td>/UseMicrosoftUpdate:[0|1]</td> <td>Specifies whether to opt in for Microsoft Update. A value of 1 will opt in. A value of 0 doesn't change the current opt-in status of the computer.</td> </tr> <tr> <td>/SendTelemetryReports:[0|1]</td> <td>Specifies Orchestrator to send Diagnostics and Usage data to Microsoft. 0 to opt out from sending Telemetry. <strong>Telemetry is on by default.</strong></td> </tr> <tr> <td>/EnableErrorReporting:[value]</td> <td>Specifies that Orchestrator should send program error reports to Microsoft. Possible values are always, queued, and never.</td> </tr> </tbody> </table> </div> <div data-moniker="sc-orch-2025"> <table> <thead> <tr> <th>Option</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>/Silent</td> <td>Installation is performed without displaying a dialog.</td> </tr> <tr> <td>/Uninstall</td> <td>Product is uninstalled. This option is performed silently.</td> </tr> <tr> <td>/Key:[Product Key]</td> <td>Specifies the product key. If no product key is specified, Orchestrator is installed as an evaluation edition.</td> </tr> <tr> <td>/ServiceUserName:[UserName]</td> <td>Specifies the user account for the Orchestrator Management Service. This value is required if you're installing Management Server, Runbook Server, or web services.</td> </tr> <tr> <td>/ServicePassword:[Password]</td> <td>Specifies the password for the user account for the Orchestrator Management Service. This value is required if you're installing Management Server, Runbook Server, or web services.</td> </tr> <tr> <td>/Components:[Feature 1, Feature 2,"]</td> <td>Specifies the features to install (comma separated). Possible values are ManagementServer, RunbookServer, RunbookDesigner, WebAPI, WebConsole and All.</td> </tr> <tr> <td>/InstallDir:[Path]</td> <td>Specifies the path to install Orchestrator. If no path is specified, C:\Program Files\Microsoft System Center<version>\Orchestrator is used.</td> </tr> <tr> <td>/DbServer:[Computer[\Instance]]</td> <td>Specifies the computer name and instance of the database server. This value is required if you're installing Management Server, Runbook Server, or web services.</td> </tr> <tr> <td>/DbUser:[UserName]</td> <td>Specifies the user account to access the database server. This value is only required for SQL Authentication. If Windows Authentication is used, no value should be specified.</td> </tr> <tr> <td>/DbPassword:[Password]</td> <td>Specifies the password for the user account to access the database server. This value is only required for SQL Authentication. If Windows Authentication is used, then no value should be specified.</td> </tr> <tr> <td>/DbNameNew:[Database Name]</td> <td>Specifies the database name if a new database is being created. Can't be used with DbNameExisting.</td> </tr> <tr> <td>/DbNameExisting:[Database Name]</td> <td>Specifies the database name if an existing database is being used. Can't be used with DbNameNew.</td> </tr> <tr> <td>/TrustServerCertificate[true\false]</td> <td>Specifies whether to trust SQL Server Certificate. <strong>Set to false by default</strong>.</td> </tr> <tr> <td>/WebServicePort:[Port]</td> <td>Specifies the port to use for the Web API service. Required if Web API service is installed.</td> </tr> <tr> <td>/WebConsolePublicUrl: [URL]</td> <td>Specifies the URL of the Orchestration Console that should be used to configure CORS on the Web API. Required if Web API service is installed.</td> </tr> <tr> <td>/WebConsolePort:[Port]</td> <td>Specifies the port to use for the Orchestrator console. Required if Orchestrator Console is installed.</td> </tr> <tr> <td>/WebServicePublicUrl:[URL]</td> <td>Specifies the URL of the web API service that should be used by the Orchestration Console. Required if Orchestration Console is installed.</td> </tr> <tr> <td>/OrchestratorUsersGroup:[Group SID]</td> <td>Specifies the SID of the domain or local group that will be granted access to Management server. If no value is specified, the default local group is used.</td> </tr> <tr> <td>/OrchestratorRemote</td> <td>Specifies that remote access should be granted to the Runbook Designer.</td> </tr> <tr> <td>/UseMicrosoftUpdate:[0|1]</td> <td>Specifies whether to opt in for Microsoft Update. A value of 1 will opt in. A value of 0 doesn't change the current opt-in status of the computer.</td> </tr> <tr> <td>/SendTelemetryReports:[0|1]</td> <td>Specifies Orchestrator to send Diagnostics and Usage data to Microsoft. 0 to opt out from sending Telemetry. <strong>Telemetry is on by default.</strong></td> </tr> <tr> <td>/EnableErrorReporting:[value]</td> <td>Specifies that Orchestrator should send program error reports to Microsoft. Possible values are always, queued, and never.</td> </tr> </tbody> </table> </div> <p>For example, you could use the following command to install all the Orchestrator components using Windows Authentication.</p> <pre><code>.\Setup.exe /Silent /ServiceUserName:<UserName> /ServicePassword:<password> /Components:All /DbServer:<DBServerName> /DbNameNew:Orchestrator /WebServicePort:81 /WebConsolePublicUrl:”http://localhost:82” /WebConsolePort:82 /WebServicePublicUrl:”http://localhost:81” /UseMicrosoftUpdate:1 /SendTelemetryReports:1 /EnableErrorReporting:always </code></pre> <h2 id="view-runbook-server-properties">View runbook server properties</h2> <p>The properties for a runbook server include an optional description and the account information to use for the Runbook Service. You can modify the description but can only view the service credentials.</p> <ol> <li><p>In the <strong>Connections</strong> pane, select the Runbook Servers folder. In the right pane, right-click the runbook server to select <strong>Properties</strong>.</p> </li> <li><p>If you want to add or change the <strong>Description</strong> box, enter a description for this runbook server, and select <strong>Finish</strong>.</p> </li> </ol> <div data-moniker="sc-orch-2022 sc-orch-2025"> <h2 id="configure-your-installation">Configure your installation</h2> <h3 id="enable-api-logging-to-file">Enable API logging to file</h3> <p>Toggle the XML attribute <code>stdoutLogEnabled</code> to <code>true</code> in your <code>web.config</code> under <code>system.WebServer</code> > <code>aspNetCore</code>.</p> <p>Irrespective of this setting, you can view logs in <strong>Event Viewer</strong> > <strong>Windows Applications</strong> > <strong>Applications</strong>.</p> <h3 id="change-your-database-settings-for-web-api">Change your database settings for Web API</h3> <p>The API is configured using the <code>web.config</code> file as mentioned <a href="/en-us/system-center/orchestrator/how-to-change-the-orchestrator-database#change-the-database-settings-for-the-orchestrator-web-service" data-linktype="absolute-path">here</a>.</p> </div> <h2 id="troubleshoot-your-installation">Troubleshoot your installation</h2> <p>The following information provides additional instructions and caveats that you can use during the installation to resolve problems you might experience.</p> <h3 id="orchestrator-log-files">Orchestrator log files</h3> <p>If you experience problems during installation, installation log files are located in the folder <strong>C:\Users\%USERNAME%\AppData\Local\SCO\LOGS</strong>.</p> <p>If you experience problems when you're running Orchestrator, the product log files are located in the folder <strong>C:\ProgramData\Microsoft System Center <version>\Orchestrator\</strong>.</p> <h3 id="windows-firewall">Windows Firewall</h3> <p>When you deploy additional Runbook Designer applications to your environment, you might see a failed installation message. To correctly install the Runbook Designer, enable the following firewall rules as they apply to your operating system and deployment configuration.</p> <h3 id="windows-firewall-with-advanced-security">Windows Firewall with advanced security</h3> <p>By default, <strong>Windows Firewall with Advanced Security</strong> is enabled on all Windows Server computers, and blocks all incoming traffic unless it's a response to a request by the host or it's specifically allowed. You can explicitly allow traffic by specifying a port number, application name, service name, or other criteria by configuring Windows Firewall with Advanced Security settings.</p> <p>Enable the following rules to allow all Monitor Event activities to function correctly:</p> <ul> <li><p>Windows Management Instrumentation (Async-In)</p> </li> <li><p>Windows Management Instrumentation (DCOM-In)</p> </li> <li><p>Windows Management Instrumentation (WMI-In)</p> </li> </ul> <h3 id="automated-deployment">Automated deployment</h3> <p>When a runbook server or Runbook Designer is installed behind a firewall, specific firewall rules are required between the remote computers that are used to deploy the runbook server and Runbook Designer. An additional rule is required for the remote connection between the Runbook Designer and the runbook server to allow the Orchestrator management service to accept remote connections. If you're using the <strong>Monitor WMI</strong> task, the runbook server requires a special firewall rule on the computer that uses PolicyModule.exe.</p> <p>Enable the following firewall rules on your computer:</p> <h4 id="firewall-rule-between-the-runbook-designer-and-the-orchestrator-management-server">Firewall rule between the Runbook Designer and the Orchestrator management server</h4> <div data-moniker="sc-orch-2022 sc-orch-2025"> <table> <thead> <tr> <th>Operating system</th> <th>Firewall rule</th> </tr> </thead> <tbody> <tr> <td>64-bit</td> <td>%ProgramFiles%\Microsoft System Center <version>\Orchestrator\Management Server\OrchestratorManagementService.exe</td> </tr> </tbody> </table> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <table> <thead> <tr> <th>Operating system</th> <th>Firewall rule</th> </tr> </thead> <tbody> <tr> <td>64-bit</td> <td>%ProgramFiles (x86)%\Microsoft System Center <version>\Orchestrator\Management Server\OrchestratorManagementService.exe</td> </tr> <tr> <td>32-bit</td> <td>%ProgramFiles%Microsoft System Center <version>\Orchestrator\Management Server\OrchestratorManagementService.exe</td> </tr> </tbody> </table> </div> <h4 id="firewall-rules-between-remote-computers">Firewall rules between remote computers</h4> <table> <thead> <tr> <th>Operating system</th> <th>Firewall rules</th> </tr> </thead> <tbody> <tr> <td>Windows Server</td> <td>- File and Printer Sharing<br>- Windows Management Instrumentation (WMI)<br>- Program rule for OrchestratorRemotingService to accept remote connections. This rule must be enabled through the Advanced Firewall mode for path %ProgramFiles%\Microsoft System Center \Orchestrator\Management Server\Deployment Manager\OrchestratorRemotingService.exe</td> </tr> </tbody> </table> <h4 id="firewall-rules-between-the-runbook-server-and-the-computer-that-uses-policymoduleexe">Firewall rules between the runbook server and the computer that uses PolicyModule.exe</h4> <div data-moniker="sc-orch-2022 sc-orch-2025"> <table> <thead> <tr> <th>Operating system</th> <th>Firewall rule</th> </tr> </thead> <tbody> <tr> <td>64-bit</td> <td>%ProgramFiles%\Microsoft System Center <version>\Orchestrator\Runbook Server\PolicyModule.exe</td> </tr> </tbody> </table> <p>For more information about adding firewall rules, see <a href="/en-us/previous-versions/orphan-topics/ws.11/cc753558(v=ws.11)" data-linktype="absolute-path">Add or Edit a Firewall Rule</a>.</p> </div> <div data-moniker="sc-orch-2016 sc-orch-2019"> <table> <thead> <tr> <th>Operating system</th> <th>Firewall rule</th> </tr> </thead> <tbody> <tr> <td>64-bit</td> <td>%ProgramFiles (x86)%\Microsoft System Center <version>\Orchestrator\Runbook Server\PolicyModule.exe</td> </tr> <tr> <td>32-bit</td> <td>%ProgramFiles\Microsoft System Center <version>\Orchestrator\Runbook Server\PolicyModule.exe</td> </tr> </tbody> </table> <p>For more information about adding firewall rules, see <a href="/en-us/previous-versions/orphan-topics/ws.11/cc753558(v=ws.11)" data-linktype="absolute-path">Add or Edit a Firewall Rule</a>.</p> </div> <h3 id="BKMK_RunbookServicefailstostart">RunbookService fails to start after computer reboot</h3> <p>When you reboot your runbook server, the RunbookService attempts to connect to the orchestration database. If the database isn't available, the RunbookService fails. The event log message is <strong>This computer was unable to communicate with the computer providing the server</strong>. Typically, this can occur when the SQL server and the runbook server are installed on the same computer.</p> <p>To solve this problem, you can manually start the RunbookService or configure the RunbookService to make multiple attempts during start-up to connect to database before failing.</p> <h3 id="cant-restart-runbook-service-if-you-uninstall-with-an-account-without-administrator-permissions">Can't restart runbook service if you uninstall with an account without administrator permissions</h3> <p>If you attempt to uninstall Orchestrator while signed in with an account that is a member of OrchestratorSystemGroup but isn't an administrator, uninstall removes all accounts from OrchestratorSystemGroup. If you stop the runbook service and attempt to restart the service, the service fails because the user account doesn't have the correct permissions to retrieve the orchestration database connection. An account that is an administrator or a member of the OrchestratorSystemGroup is required to retrieve the orchestration database connection.</p> <p>To solve this problem, an administrator can add the user back to OrchestratorSystemGroup.</p> <h2 id="next-steps">Next steps</h2> <ul> <li>To learn more about building runbooks, see <a href="design-and-build-runbooks?view=sc-orch-2025" data-linktype="relative-path">Design and build runbooks</a>.</li> <li>To learn more about deploying runbooks, see <a href="deploy-runbooks?view=sc-orch-2025" data-linktype="relative-path">Deploy runbooks</a>.</li> </ul> </div><div id="ms--inline-notifications" class="margin-block-xs" data-bi-name="inline-notification"></div><div id="assertive-live-region" role="alert" aria-live="assertive" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div> <div id="polite-live-region" role="status" aria-live="polite" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div>  </main> <section id="site-user-feedback-footer" class="font-size-sm margin-top-md" data-test-id="site-user-feedback-footer" data-bi-name="site-feedback-section"> <hr class="hr" /> <h2 id="feedback" class="title is-3">Feedback</h2> <div class="display-flex flex-wrap-wrap align-items-center"> <p class="font-weight-semibold margin-xxs margin-left-none">Was this page helpful?</p> <div class="buttons"> <button class="thumb-rating-button like button button-primary button-sm" data-test-id="footer-rating-yes" data-binary-rating-response="rating-yes" type="button" title="This article is helpful" data-bi-name="button-rating-yes" aria-pressed="false" > <span class="icon" aria-hidden="true"> <span class="docon docon-like"></span> </span> <span>Yes</span> </button> <button class="thumb-rating-button dislike button button-primary button-sm" data-test-id="footer-rating-no" data-binary-rating-response="rating-no" type="button" title="This article is not helpful" data-bi-name="button-rating-no" aria-pressed="false" > <span class="icon" aria-hidden="true"> <span class="docon docon-dislike"></span> </span> <span>No</span> </button> </div> </div><div class="display-flex flex-wrap-wrap margin-top-xxs"><div> <a data-bi-name="provide-feedback-cta" class="has-external-link-indicator" href="https://feedback.azure.com/d365community/" data-bi-name="product-feedback" > <span>Provide product feedback</span> </a><span class="margin-inline-xxs" aria-hidden="true">|</span></div><a href="https://learn.microsoft.com/en-us/answers/tags/182/msc.html" class="has-external-link-indicator" data-bi-name="get-help-at-qna"> <span>Get help at Microsoft Q&A</span> </a></div> </section> <aside id="ms--additional-resources-mobile" aria-label="Additional resources" class="display-none-desktop display-none-print" > <hr class="hr" hidden /> <h2 id="ms--additional-resources-mobile-heading" class="title is-3" hidden>Additional resources</h2> <section id="right-rail-recommendations-mobile" data-bi-name="recommendations" hidden></section> <section id="right-rail-training-mobile" data-bi-name="learning-resources-card" hidden></section> <section id="right-rail-events-mobile" data-bi-name="events-card" hidden></section> <section id="right-rail-qna-mobile" data-bi-name="qna-link-card" hidden></section> </aside><div class="border-top is-visible-interactive has-default-focus margin-top-sm "><footer id="footer-interactive" data-bi-name="footer" class="footer-layout"><div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop"><a data-mscc-ic="false" class="locale-selector-link button button-sm button-clear flex-shrink-0" href="#" data-bi-name="select-locale"> <span class="icon" aria-hidden="true"> <span class="docon docon-world"></span> </span> <span class="local-selector-link-text"></span></a><div class="ccpa-privacy-link" data-ccpa-privacy-link hidden> <a href="https://aka.ms/yourcaliforniaprivacychoices" class="button button-sm button-clear flex-shrink-0" data-mscc-ic="false" data-bi-name="your-privacy-choices" > <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 30 14" xml:space="preserve" height="16" width="43" aria-hidden="true" focusable="false" > <path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path> <path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path> <path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path> <path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path> </svg> <span>Your Privacy Choices</span> </a> </div> <div class="flex-shrink-0"> <div class="dropdown has-caret-up"> <button class="dropdown-trigger button button-clear button-sm has-inner-focus theme-dropdown-trigger" aria-controls="theme-menu-interactive" aria-expanded="false" title="Theme" data-bi-name="theme"> <span class="icon"> <span class="docon docon-sun" aria-hidden="true"></span> </span> <span>Theme</span> <span class="icon expanded-indicator" aria-hidden="true"> <span class="docon docon-chevron-down-light"></span> </span> </button> <div class="dropdown-menu" id="theme-menu-interactive" role="menu"> <ul class="theme-selector padding-xxs" role="none"> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="light"> <span class="theme-light margin-right-xxs"> <span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Light</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="dark"> <span class="theme-dark margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Dark</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="high-contrast"> <span class="theme-high-contrast margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>High contrast</span> </button> </li> </ul> </div> </div> </div> </div> <ul class="links" data-bi-name="footerlinks"> <li class="manage-cookies-holder" hidden></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/previous-versions/" data-bi-name="archivelink">Previous Versions</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink">Blog</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/contribute/" data-bi-name="contributorGuide">Contribute</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://go.microsoft.com/fwlink/?LinkId=521839" data-bi-name="privacy">Privacy</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/legal/termsofuse" data-bi-name="termsofuse">Terms of Use</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks">Trademarks</a></li><li>© Microsoft 2025</li> </ul> </footer></div></div><div id="ms--additional-resources" class="right-container column is-4-desktop display-none display-block-desktop" data-bi-name="pageactions" role="complementary" aria-label="Additional resources" > <div id="affixed-right-container" class="margin-top-sm-tablet" data-bi-name="right-column"> <h2 id="ms--additional-resources-heading" class="title is-6 margin-top-md" hidden>Additional resources</h2> <section id="right-rail-events" data-bi-name="events-card" hidden></section> <section id="right-rail-training" data-bi-name="learning-resources-card" hidden></section> <section id="right-rail-recommendations" data-bi-name="recommendations" hidden></section> <nav id="side-doc-outline" class="doc-outline" data-bi-name="intopic toc" aria-label="In this article"> <h3>In this article</h3> </nav> <section id="right-rail-qna" class="margin-top-xxs" data-bi-name="qna-link-card" hidden></section> </div> </div></div>  </section>   <aside id="interactive-container" class="interactive-container is-visible-interactive column has-body-background-dark "> </aside>  </div> </div>  <section class="border-top has-default-focus is-hidden-interactive margin-top-sm "><footer id="footer" data-bi-name="footer" class="footer-layout uhf-container has-padding" role="contentinfo"><div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop"><a data-mscc-ic="false" class="locale-selector-link button button-sm button-clear flex-shrink-0" href="#" data-bi-name="select-locale"> <span class="icon" aria-hidden="true"> <span class="docon docon-world"></span> </span> <span class="local-selector-link-text"></span></a><div class="ccpa-privacy-link" data-ccpa-privacy-link hidden> <a href="https://aka.ms/yourcaliforniaprivacychoices" class="button button-sm button-clear flex-shrink-0" data-mscc-ic="false" data-bi-name="your-privacy-choices" > <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 30 14" xml:space="preserve" height="16" width="43" aria-hidden="true" focusable="false" > <path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path> <path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path> <path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path> <path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path> </svg> <span>Your Privacy Choices</span> </a> </div> <div class="flex-shrink-0"> <div class="dropdown has-caret-up"> <button class="dropdown-trigger button button-clear button-sm has-inner-focus theme-dropdown-trigger" aria-controls="theme-menu" aria-expanded="false" title="Theme" data-bi-name="theme"> <span class="icon"> <span class="docon docon-sun" aria-hidden="true"></span> </span> <span>Theme</span> <span class="icon expanded-indicator" aria-hidden="true"> <span class="docon docon-chevron-down-light"></span> </span> </button> <div class="dropdown-menu" id="theme-menu" role="menu"> <ul class="theme-selector padding-xxs" role="none"> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="light"> <span class="theme-light margin-right-xxs"> <span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Light</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="dark"> <span class="theme-dark margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Dark</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="high-contrast"> <span class="theme-high-contrast margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>High contrast</span> </button> </li> </ul> </div> </div> </div> </div> <ul class="links" data-bi-name="footerlinks"> <li class="manage-cookies-holder" hidden></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/previous-versions/" data-bi-name="archivelink">Previous Versions</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink">Blog</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/contribute/" data-bi-name="contributorGuide">Contribute</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://go.microsoft.com/fwlink/?LinkId=521839" data-bi-name="privacy">Privacy</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/legal/termsofuse" data-bi-name="termsofuse">Terms of Use</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks">Trademarks</a></li><li>© Microsoft 2025</li> </ul> </footer> </section> <div id="action-panel" role="region" aria-label="Action Panel" class="action-panel has-default-focus" tabindex="-1"></div> </body> </html>