{"id":11041,"date":"2012-06-26T16:35:00","date_gmt":"2012-06-26T16:35:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2012\/06\/26\/basic-installation-guide-for-windows-powershell-web-access\/"},"modified":"2024-02-28T13:13:37","modified_gmt":"2024-02-28T21:13:37","slug":"basic-installation-guide-for-windows-powershell-web-access","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/basic-installation-guide-for-windows-powershell-web-access\/","title":{"rendered":"Basic installation guide for Windows PowerShell Web Access"},"content":{"rendered":"

Windows PowerShell Web Access<\/a> is a new feature in Windows Server 2012. It is an IIS application that provides a Windows PowerShell console in a web browser. The IIS application acts as a gateway between the web browser and the machines that you can connect to in your environment. These machines should have Windows PowerShell remoting enabled.<\/p>\n

The video\u00a0below illustrates the three simple steps of setup and configuration \u2013<\/p>\n

1.\u00a0Feature installation<\/strong>\nIn the video we use GUI to install the feature. We could also use the Windows PowerShell cmdlet equivalent for installation (run the cmd in an elevated PowerShell console) \u2013\nInstall-WindowsFeature \u2013Name WindowsPowerShellWebAccess \u2013IncludeAllManagementTools<\/span><\/p>\n

2.\u00a0Web application setup in IIS<\/strong>\nAfter successful feature installation, IIS has to be configured to host the web application. The video illustrates automated setup for IIS using the cmdlet Install-PswaWebApplication where<\/span><\/span>\u00a0default values are used by the cmdlet to setup the web application and the website.<\/p>\n

\"Image<\/a><\/p>\n

If you don\u2019t wish to use the default values, you can specify values for \u2013WebApplicationName<\/span> and \u2013WebsiteName<\/span> parameters for the cmdlet. You can also configure IIS manually. More details on different ways to configure IIS are available in Windows PowerShell Web Access help document<\/a>.<\/p>\n

3.\u00a0Configuring authorization rules<\/strong>\nThe authorization rules act as a white list and help manage access control to the gateway and the remote machine. Without the authorization rules, no user will be able to use PSWA\u2019s website to login and manage a remote machine.<\/p>\n

In the video, we create one authorization rule for the administrator to login to the pswagateway machine. As specified by the rule, the administrator will only be able to connect to the default PowerShell endpoint, i.e. Microsoft.PowerShell on the machine pswagateway. The login will fail if the administrator tries to connect to some other machine or some other PowerShell endpoint on pswagateway.<\/p>\n

There may be other local or built-in users on pswagateway machine who have access rights to manage the machine using other remote connection software such as Remote Desktop services etc. But, they cannot connect to pswagateway via PowerShell Web Access<\/a> because no authorization rule is created for them. Therefore, authorization rules provide an additional layer of security on top of the existing access control rights on the machine.<\/p>\n

More details on authorization rules can be found in Windows PowerShell Web Access help document<\/a>. Also, stay tuned for a blog post on authorization rules.\nIn all, Windows PowerShell Web Access<\/a> provides a secure way to access a remote PowerShell console in a web browser. This provides mobility and ease of access. Since the web console is accessible via a website, users can now connect to their remote machines from various mobile devices such as tablets, phones etc.<\/p>\n

 <\/p>\n

Kriti Jindal<\/p>\n

Program Manager<\/p>\n

Windows PowerShell Web Access<\/p>\n

Microsoft Corporation<\/p>\n

 <\/p>\n

Click here<\/a> to download the video.\n[Video]<\/p>\n","protected":false},"excerpt":{"rendered":"

Windows PowerShell Web Access is a new feature in Windows Server 2012. It is an IIS application that provides a Windows PowerShell console in a web browser. The IIS application acts as a gateway between the web browser and the machines that you can connect to in your environment. These machines should have Windows PowerShell […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[271,352],"class_list":["post-11041","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-powershell-web-access","tag-windows-server-2012"],"acf":[],"blog_post_summary":"

Windows PowerShell Web Access is a new feature in Windows Server 2012. It is an IIS application that provides a Windows PowerShell console in a web browser. The IIS application acts as a gateway between the web browser and the machines that you can connect to in your environment. These machines should have Windows PowerShell […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/11041","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=11041"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/11041\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=11041"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=11041"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=11041"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}