{"id":35244,"date":"2019-02-26T08:56:16","date_gmt":"2019-02-26T15:56:16","guid":{"rendered":"http:\/\/devblogs.microsoft.com\/premier-developer\/?p=35244"},"modified":"2019-02-21T09:06:33","modified_gmt":"2019-02-21T16:06:33","slug":"iis-remote-management-for-docker-containers","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/premier-developer\/iis-remote-management-for-docker-containers\/","title":{"rendered":"IIS Remote Management for Docker Containers"},"content":{"rendered":"

Premier Developer Consultant <\/span>Randy Patterson<\/a> walks use through IIS remote management for Docker containers.<\/span><\/p>\n

\n

When running IIS in a Windows Container, you configure it using PowerShell commands in your Dockerfile. While determining the correct PowerShell commands is not a difficult process it is inconvenient to verify the settings using the command line only. Sometimes, you just need a UI to quickly view and manage your IIS configuration.<\/p>\n

Fortunately, Internet Information Services (IIS) Manager<\/em> for Windows allows remote management of IIS server including running in a container. However, it is not enabled by default for Windows Containers.<\/p>\n

Required Steps:<\/p>\n

    \n
  1. Enable Remote Management in the Docker image<\/li>\n
  2. Add an Admin user to the container image to allow IIS Remote Manager to login<\/li>\n
  3. Connect to container using IIS Remote Manager<\/li>\n<\/ol>\n

    Enable Remote Management in the Docker Image<\/h2>\n

    The first step to enable remote management is to install the Web-Mgmt-Service and configure it to automatically start when the container starts. Additionally, an admin user needs to be added to the container to allow the Remote IIS Manager UI to remotely connect and manage IIS<\/p>\n

    FROM microsoft\/iis<\/code><\/p>\n

    SHELL [ \"powershell\" ]<\/code><\/p>\n

    #setup Remote IIS management<\/code><\/p>\n

    RUN Install-WindowsFeature Web-Mgmt-Service; \\<\/code><\/p>\n

    New-ItemProperty -Path HKLM:\\software\\microsoft\\WebManagement\\Server -Name EnableRemoteManagement -Value 1 -Force; \\<\/code><\/p>\n

    Set-Service -Name wmsvc -StartupType automatic;<\/code><\/p>\n

    #Add user for Remote IIS Manager Login<\/code><\/p>\n

    RUN net user iisadmin Password~1234<\/strong> \/ADD; \\<\/code><\/p>\n

    net localgroup administrators iisadmin \/add;<\/code><\/p>\n

    Step 1: Create an image using the above Dockerfile<\/h3>\n

    docker build -t iisremote .<\/code><\/p>\n

    \"C:\\Users\\ranpat\\AppData\\Local\\Temp\\SNAGHTML1e5790f2.PNG\"<\/p>\n

    Figure : Build Image Sample Output<\/p>\n

    Step 2: Start the container<\/h3>\n

    docker run --name remoteiis -d iisremote<\/code><\/p>\n

    Step 3: Display the IP Address of the running container<\/h3>\n

    docker inspect --format '{{ .NetworkSettings.Networks.nat.IPAddress }}' remoteiis<\/code><\/p>\n

    Connect to IIS running in the container<\/h2>\n

    Finally, start IIS Manager then right click on Start Page and click Connect to Server<\/p>\n

    \"E:\\SystemTemp\\SNAGHTML202db6db.PNG\"<\/p>\n

    If you do not have a \u201cStart Page\u201d or \u201cConnect to Server\u201d then install the IIS Remote Manager Plugin located here https:\/\/www.iis.net\/downloads\/microsoft\/iis-manager<\/a><\/p>\n

    Enter the IP Address from Step 3 above<\/p>\n

    <\/p>\n

    Next, enter the Remote IIS Manager Login from the Docker file in Step 1 above. The default is iisadmin\/Password~1234 <\/em><\/strong><\/p>\n

    <\/p>\n

    If you get a certificate warning, click Connect<\/strong><\/p>\n

    <\/p>\n

    On the next dialog, keep the default connection name and press the Finish <\/strong>button. You can now use IIS Manager to remotely configure IIS running in a container.<\/p>\n

    <\/p>\n","protected":false},"excerpt":{"rendered":"

    When running IIS in a Windows Container, you configure it using PowerShell commands in your Dockerfile. While determining the correct PowerShell commands is not a difficult process it is inconvenient to verify the settings using the command line only. Sometimes, you just need a UI to quickly view and manage your IIS configuration.<\/p>\n","protected":false},"author":582,"featured_media":35251,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[55],"tags":[2,29,314],"class_list":["post-35244","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-web","tag-containers","tag-docker","tag-randy-patterson"],"acf":[],"blog_post_summary":"

    When running IIS in a Windows Container, you configure it using PowerShell commands in your Dockerfile. While determining the correct PowerShell commands is not a difficult process it is inconvenient to verify the settings using the command line only. Sometimes, you just need a UI to quickly view and manage your IIS configuration.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/35244","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/users\/582"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/comments?post=35244"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/35244\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media\/35251"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media?parent=35244"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/categories?post=35244"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/tags?post=35244"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}