次の方法で共有


Add-SCApplicationHostTemplate

アプリケーション ホスト テンプレートをサービス テンプレートに追加します。

構文

Add-SCApplicationHostTemplate
   [-DeploymentOrder <Int32>]
   [-ServicingOrder <Int32>]
   [-Name] <String>
   [-Description <String>]
   [-Tag <String>]
   -ComputerName <String>
   -ApplicationProfile <ApplicationProfile>
   -ServiceTemplate <ServiceTemplate>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCApplicationHostTemplate
   [-DeploymentOrder <Int32>]
   [-ServicingOrder <Int32>]
   [-Port <Int32>]
   [-AllowUntrustedServerCertificate <Boolean>]
   -RunAsAccount <VMMCredential>
   [-WebApplicationHost]
   [-Name] <String>
   [-Description <String>]
   [-Tag <String>]
   -ComputerName <String>
   -Site <String>
   [-AuthenticationType <String>]
   -ApplicationProfile <ApplicationProfile>
   -ServiceTemplate <ServiceTemplate>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Add-SCApplicationHostTemplate コマンドレットは、サービス テンプレートにアプリケーション ホスト テンプレートを追加します。 アプリケーション ホスト テンプレートは、SQL データ層アプリケーション (DAC) をデプロイされた SQL サーバーまたは Web 配置パッケージに、サポートされている Web アプリケーション ホストにデプロイするために使用されます。

例 1: SQL アプリケーション ホスト テンプレートをサービス テンプレートに追加する

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Add-SCApplicationHostTemplate -Name "SQL Application Host" -ComputerName "SQLServer01.Contoso.com" -ApplicationProfile $AppProfile -ServiceTemplate $ServiceTemplate

最初のコマンドは、SvcWebAppProfile01 という名前の aplication プロファイル オブジェクトを取得し、$AppProfile変数にオブジェクトを格納します。

2 番目のコマンドは、ServiceTemplate01 という名前の service temnplate オブジェクトを取得し、$ServiceTemplate変数にオブジェクトを格納します。

3 番目のコマンドは、$ServiceTemplateに格納されているサービス テンプレートにアプリケーション ホスト テンプレートを追加します。

例 2: Web アプリケーション ホスト テンプレートをサービス テンプレートに追加する

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "WebAppProfile01"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $WebRAA = Get-SCRunAsAccount -Name "IIS Site Admin"
PS C:\> $WebAppHostTemplate = Add-SCApplicationHostTemplate -Name "Web Farm" -ServiceTemplate $ServiceTemplate -ApplicationProfile -$AppProfile -ComputerName "@Web Server@" -DeploymentOrder 2 -WebAppHost -Port 8172 -Site "Default Web Site" -AuthenticationType "NTLM" -AllowUntrustedServerCertificate -RunAsAccount $WebRAA

最初のコマンドは、WebAppProfile01 という名前の aplication プロファイル オブジェクトを取得し、$AppProfile変数にオブジェクトを格納します。

2 番目のコマンドは、ServiceTemplate01 という名前のサービス テンプレート オブジェクトを取得し、$ServiceTemplate変数にオブジェクトを格納します。

3 番目のコマンドは、IIS サイト管理者という名前の実行アカウント オブジェクトを取得し、$WebRAA変数にオブジェクトを格納します。

最後のコマンドは、$ServiceTemplateに格納されているサービス テンプレート (この場合は ServiceTemplate01) に Web アプリケーション ホスト テンプレートを追加します。

パラメーター

-AllowUntrustedServerCertificate

ターゲット展開サーバーが信頼されていないサーバー証明書を提示したときに、展開を続行できるかどうかを示します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ApplicationProfile

アプリケーション プロファイル オブジェクトを指定します。

型:ApplicationProfile
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-AuthenticationType

テンプレートに関連付けられている Web アプリケーションのデプロイを容易にするために使用される認証メカニズムを指定します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。 有効な値は NTLM と Basic です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ComputerName

Virtual Machine Manager (VMM) がネットワーク上で一意に識別できるコンピューターの名前を指定します。 有効な形式は次のとおりです。

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名
型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeploymentOrder

コンピューター層、アプリケーション ホスト、またはアプリケーションを展開する順序を指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

アプリケーション ホスト テンプレートの説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobVariable

ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

VMM オブジェクトの名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Port

オブジェクトの追加または接続の作成時に使用するネットワーク ポートを指定します。 有効な値は 1 から 4095 です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsAccount

このアクションを実行するアクセス許可を持つ資格情報を含む実行アカウントを指定します。

型:VMMCredential
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServiceTemplate

サービス テンプレート オブジェクトを指定します。

型:ServiceTemplate
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicingOrder

コンピューター層またはアプリケーション ホストが処理される順序を指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Site

関連付けられている Web 展開パッケージの展開先となる Web サイトを指定します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tag

指定したタグのセットを持つすべてのオブジェクトを検索できるように、オブジェクトに関連付ける単語または語句を指定します。 タグのサブセットを検索することも、タグの完全なセットを検索することもできます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WebApplicationHost

アプリケーション ホスト テンプレートを Web アプリケーション ホストに使用することを指定します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

ApplicationHostTemplate

このコマンドレットは、ApplicationHostTemplate オブジェクトを返します。