Web 配置のセットアップを自動化するための PowerShell スクリプト

作成者: Kristina Olson

Web 配置の v2.1 リリースでは、ユーザーが Web 配置を使用して公開できるように IIS サーバーを簡単に構成できる PowerShell スクリプトがいくつかインストールされています。 このページでは、これらのスクリプトを使用して、既定の公開サイトの作成、新規または既存のサイトとユーザーの公開の有効化、SQL または MySQL データベースの公開の作成、委任規則の設定 (すべて PowerShell を使用) する方法について説明します。

使用するスクリプトは次のとおりです。

• SetupSiteForPublish.ps1
• CreateSqlDatabase.ps1
• CreateMySqlDatabase.ps1
• AddDelegationRules.ps1

要件

• サーバーには、IIS7 が付属するオペレーティング システムが必要です。これは、Windows Server 2008 または Windows Server 2008 R2 を意味します。 そのマシンの管理者である必要があります。

• 次の条件が満たされていることを確認します。

  • PowerShell2 をインストールする必要があります (これは Windows Server 2008 R2 に組み込まれています。Windows Server 2008 の場合は、https://www.catalog.update.microsoft.com/ScopedViewInline.aspx?updateid=0be83604-db27-4b99-976a-136a92bd579b から更新プログラムとして PowerShell2 を取得できます。 再起動が必要です。
  • サーバー マネージャーで Web サーバー (IIS) ロールを有効にする必要があります。
  • サーバー マネージャーで IIS の Web 管理サービスの役割サービス ("管理サービス") を有効にする必要があります
  • PowerShell データベース スクリプトを使用するには、サーバーが SQL または MySQL データベースにアクセスできる必要があります。 SQL Server 管理オブジェクトも SQL 用にインストールする必要があります。
  • Web 配置は、管理サービス統合コンポーネントと共にインストールする必要があります。 (このオプションを Web 配置インストーラーに表示するにはまず、Web 管理サービスを有効にする必要があります。)

PowerShell の一般的な手順

1. Azure PowerShell コマンド ウィンドウを起動します。

   タスク バーの PowerShell アイコンをクリックするか、[スタート] をクリックし、「PowerShell」と入力して、[Windows PowerShell] を選択します。
   
   (青いアイコン)

2. 実行ポリシーでスクリプトの実行が許可されていることを確認します。

   1. 「Get-ExecutionPolicy」と入力します。 制限済み (既定値) の場合は、「Set-ExecutionPolicy AllSigned」と入力するなど、より制限の緩い設定にリセットする必要があります。 AllSigned 設定では、署名付きスクリプトの実行が許可されますが、信頼されていない場合はプロンプトが表示されます

   2. 実行ポリシー設定の詳細については、Set-ExecutionPolicy コマンドレットの使用を参照してください。

3. Web 配置スクリプトのディレクトリに変更します。

   1. 型 cd '%programfiles%\IIS\Microsoft Web Deploy v2\Scripts' (ただし、%programfiles% を C:\Program Files などの実際のパスに置き換えます)。

SetupSiteForPublish スクリプトを使用して既定の公開 Web サイトを作成する (データベースなし)

引数なしで SetupSiteForPublish.ps1 スクリプトを実行します。

これにより、次の処理が実行されます。

このスクリプトは、管理者以外の公開用のユーザーとサイトを作成し、公開プロファイル情報をデスクトップ上のファイルに保存します。 具体的には、%systemdrive%\inetpub\WDeploySite に物理サイト ルートを持つ WDeploySite というサイトを作成します。 サイトには WDeployAppPool という一致するアプリケーション プールがあり、既定でポート 8080 (または別のサイトが 8080 を使用している場合は次に使用可能なポート) に割り当てられます。 また、このスクリプトでは、WDeploySiteuser という管理者以外のローカル Windows ユーザーを作成し、そのユーザーに WDeploySite フォルダーにフル コントロール ACL を、サイトに IIS マネージャーのアクセス許可を付与します。 設定情報は、デスクトップの WDeploy.PublishSettings という名前のファイルに保存されます。このファイルは、サイトに公開するために WebMatrix (または Visual Studio) によって使用される場合があります。 このプロファイルには、現時点ではデータベース公開情報は含まれていません。

SetupSiteForPublish スクリプトを使用して、任意のサイトとユーザーの Web 配置による公開を有効にします。

スクリプト: SetupSiteForPublish.ps1

説明: 指定したサイトとユーザー アカウントに対して、指定したユーザーが指定したサイトに公開できるようにします。 このスクリプトは、ユーザー アカウント、サイト、アプリケーション プールを作成し、サイトのディレクトリ ACL と IIS マネージャーのアクセス許可を設定し、設定情報をファイルに保存します。

パラメーター:

例:

既存のサイトで既存のユーザーの公開を有効にします (パスワードは設定ファイルに保存されません)。

.\SetupSiteForPublish.ps1 -siteName ExistingSite -deploymentUserName UserA -publishSettingSavePath C:\profiles -publishSettingFileName UserA.PublishSettings

公開設定ファイルのカスタム名と場所を使用して、新しいサイトで新しいユーザーの公開を有効にします。

.\SetupSiteForPublish.ps1 -siteName NewSite -sitePhysicalPath C:\inetpub\NewSiteRoot -siteAppPoolName NewSitePool -sitePort 81 -deploymentUserName NewSiteUser -deploymentUserPassword Passw0rd -publishSettingSavePath C:\profiles -publishSettingFileName NewSite.PublishSettings

PublishSettings ファイルには、新しいユーザー パスワードも含まれています。 接続文字列フィールドが空であることに注意してください。このフィールドには手動で入力することも、データベース生成スクリプトを使用してプロファイルに追加することもできます。

<?xml version="1.0" encoding="utf-8"?>
<publishData>
  <publishProfile publishUrl="RWS-2008R2" msdeploySite="NewSite" destinationAppUrl="http://RWS-2008R2:81" mySQLDBConnectionString="" SQLServerDBConnectionString="" profileName="Default Settings" publishMethod="MSDeploy" userName="NewSiteUser" userPWD="Passw0rd" savePWD="True" />
</publishData>

CreateSqlDatabase スクリプトを使用して公開アカウント用の SQL データベースを作成する

スクリプト: CreateSqlDatabase.ps1

説明: データベース、ログイン、データベースに対する db_owner 権限を持つデータベース ユーザーを作成し、対応する接続文字列情報を設定ファイルに保存します。

パラメーター:

全般

例:

既定値 (ローカル SQLExpress データベース) を使用して、ユーザーを含むデータベースを作成します。

.\CreateSqlDatabase.ps1

新しいデータベースを作成し、既存の公開設定ファイル c:\profiles\UserA.PublishSettings に接続文字列情報を追加します。

PS C:\Program Files\IIS\Microsoft Web Deploy V2\Scripts> .\CreateSqlDatabase.ps1 -databaseName UserADb -databaseUserName UserADbUser -databaseUserPassword Passw0rdA -databaseAdminUser sa -databaseAdminPassword Passw0rd -sqlServerInstanceName .\SQLExpress -publishSettingSavePath C:\profiles -publishSettingFileName UserA.PublishSettings

CreateMySqlDatabase スクリプトを使用して公開アカウント用の MySQL データベースを作成する

スクリプト: CreateMySqlDatabase.ps1

説明: データベースを作成し、データベースに対するすべての権限を持つデータベース ユーザー (localhost) を作成し、接続文字列情報を設定ファイルに保存します。

パラメーター:

全般:

*serverHostName に localhost 値以外を指定し、ユーザーのアクセス許可を変更しない場合、ユーザーは自分のデータベースにアクセスできない可能性があります。 既定では、このスクリプトで付与されたアクセス許可によって、ローカル コンピューターからのデータベース ユーザー アクセスが提供されます。 データベース サーバーが同じコンピューターでホストされていない場合は、PowerShell スクリプトのアクセス許可付与セクションを変更して、次のスクリプト行を変更して任意のコンピューターからのアクセスを許可するなど、より一般的なアクセス許可を付与する必要があります。

既定のスクリプトのアクセス許可行:

$createUserScript = "Grant all privileges on {0}.* to '{1}'@'localhost' identified by '{2}';"

変更されたスクリプトのアクセス許可行:

$createUserScript = "Grant all privileges on {0}.* to '{1}'@'%' identified by '{2}';"

例:

既定値を使用して、ユーザーを含むデータベースを作成します。

.\CreateMySqlDatabase.ps1

新しいデータベースを作成し、既存の公開設定ファイル c:\profiles\UserA.PublishSettings に接続文字列情報を追加します。

.\CreateMySqlDatabase.ps1 -databaseName UserADb -databaseUsername UserADbUser -databaseUserPassword Passw0rd -databaseAdminUser root -databaseAdminPassword iis6!dfu -publishSettingSavePath C:\profiles -publishSettingFileName UserA.PublishSettings

AddDelegationRules スクリプトを使用してサーバーの委任規則を設定する

スクリプト: AddDelegationRules.ps1

説明: このスクリプトは、フル インストール中にインストーラーによってセットアップ時に自動的に実行されますが、フル インストールを実行しなかった場合や、ルールをいつでも修復する場合は、この AddDelegationRules スクリプトを再実行できます。

パラメーター: