通过 C# 进行 IIS 7 远程管理

Question

我一直在研究 Microsoft.Web.Administration.dll 和 ServerManager 类，试图控制我们的 Windows Server 2008 IIS 7 实例。

我已启用远程管理，并且可以通过 IIS 远程管理工具进行连接。但是，当我尝试使用以下命令时，我无法连接：

ServerManager.OpenRemote(serverName);

此类不允许我像 IIS 远程管理工具那样在远程 IIS 7 服务器上指定用户名和密码。

这一切都是通过我们的构建过程使用 NAnt 调用的。

其他人如何控制远程 IIS 7 服务器作为其 CI 设置的一部分？

Answer 1

您需要在具有更改配置文件的正确权限的域用户（Active Directory 用户）下运行该应用程序。

Windows 身份验证将完成剩下的工作。

Answer 2

正如 Oded 所说，您需要 Active Directory能够使用ServerManager打开到远程服务器的连接。

假设您有管理员 RDP 访问服务器，则有一种替代方法是使用 WinRM 和远程 PowerShell（与最新版本 WinRM 附带的 PowerShell 2.0 配合使用效果最佳）：

Windows 远程管理命令行工具 (Winrm .cmd）

为不在域中的两台计算机快速配置 WinRM：

客户端：

winrm quickconfig  (just say yes)
winrm set winrm/config/Client/Auth '@{Basic="true"}'
:: Only do this next line if not using HTTPS
winrm set winrm/config/Client '@{AllowUnencrypted="true"}'
winrm set winrm/config/Client '@{TrustedHosts="hostname_or_ip"}'

服务器：

winrm quickconfig (just say yes)
winrm set winrm/config/Service/Auth '@{Basic="true"}'

:: See: http://support.microsoft.com/kb/2019527 regarding https
winrm quickconfig -transport:https

:: Only do this if not using HTTPS AND you are happy about sending credentials
:: in clear text.
winrm set winrm/config/Service '@{AllowUnencrypted="true"}'

现在有一些注意事项。 WinRM 将在 Windows 防火墙中为侦听器的端口 5985 和 5986 打一个洞（如果运行 Windows Server 2003 它将使用端口 80 和 443）。这可能不符合您的喜好，您最好与网络管理员讨论如何确保其安全。

配置 WinRM 后，您将需要在作为管理员组成员的远程服务器上配置用户帐户。完成后就可以测试了。在构建服务器上：

# the following line will prompt for a username and password, enter the name of the account
# you just configured on the IIS box
$cred = Get-Credential

# next test the connection
Test-WSMan -ComputerName <server_name_or_ip> -Authentication default `
           -Credential $cred

如果一切顺利，您应该看到以下响应：

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.x
                  sd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.1.7600 SP: 0.0 Stack: 2.0

接下来是连接到远程 PowerShell 会话：

Enter-PSSession <server_name_or_ip_address> -Authentication default -Credential $cred

如果成功，您应该在远程计算机上看到 PowerShell 提示符。

使用远程 PowerShell，您可以加载 PowerShell 的 Web 管理提供程序并按照您的意愿操作 IIS 的许多方面：

Windows PowerShell 的 Web 管理 (IIS) 提供程序

要连接到远程服务器，您需要提供一个 PSCredential 对象。如上所述，您可以使用以下方式提供此信息：

$cred = Get-Credential

但是，这总是需要键盘进行一些交互来提供用户名和密码。显然这对于​​自动化 CI 没有好处。

但是，您可以将密码存储在文件中。为此，只需运行以下命令一次（或每当密码更改时）：

read-host -assecurestring | convertfrom-securestring | out-file C:\securestring.txt

然后，当您需要创建 PSCredential 来向远程服务器进行身份验证时：

$username = "deployment_user"
$password = cat C:\securestring.txt | convertto-securestring
$cred = new-object -typename System.Management.Automation.PSCredential `
         -argumentlist $username, $password

$serverNameOrIp = "192.168.1.1"
Enter-PSSession $serverNameOrIp -Authentication default -Credential $cred

上述脚本源自以下博客条目，但我已复制并保存在此处，以防文章变黑：

在没有提示的情况下使用 PSCredentials - GeeksWithBlogs (archive.org)

无论如何，一旦您连接到远程服务器，您就可以发出进一步的命令，例如：

Import-Module WebAdministration
CD IIS:\Sites

等等。

如果这台机器面向互联网并且唯一的访问方式是通过互联网，则应谨慎对待上述大多数内容。如果是这种情况，请考虑将 WinRM 端口仅限于 VPN。

Answer 3

最后我写了一个 WCF 服务，它作为服务运行在远程计算机上。该服务在具有管理员权限的本地帐户下运行，以便可以更改该计算机上的本地 IIS 实例。

在我的 NAnt 脚本中，我有一系列与 WCF 服务通信并根据需要更改 IIS 设置的自定义任务。

由于这是一个内部开发环境，我不太关心安全性，并且我允许对 IIS 进行的实际更改非常基本。