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 Site 管理という名前の実行アカウント オブジェクトを取得し、$WebRAA変数にオブジェクトを格納します。
最後のコマンドは、$ServiceTemplateに格納されているサービス テンプレート (この場合は ServiceTemplate01) に Web アプリケーション ホスト テンプレートを追加します。
パラメーター
-AllowUntrustedServerCertificate
ターゲット 展開サーバーが信頼されていないサーバー証明書を提示したときに、展開を続行できるかどうかを示します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationProfile
アプリケーション プロファイル オブジェクトを指定します。
Type: | ApplicationProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AuthenticationType
テンプレートに関連付けられている Web アプリケーションのデプロイを容易にするために使用される認証メカニズムを指定します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。 有効な値は NTLM と Basic です。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
仮想マシン マネージャー (VMM) がネットワーク上で一意に識別できるコンピューターの名前を指定します。 有効な形式:
- FQDN
- IPv4 または IPv6 アドレス
- NetBIOS 名
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentOrder
コンピューター層、アプリケーション ホスト、またはアプリケーションを展開する順序を指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
アプリケーション ホスト テンプレートの説明を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
VMM オブジェクトの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
オブジェクトを追加するとき、または接続を作成するときに使用するネットワーク ポートを指定します。 有効な値は 1 から 4095 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsAccount
このアクションを実行するアクセス許可を持つ資格情報を含む実行アカウントを指定します。
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceTemplate
サービス テンプレート オブジェクトを指定します。
Type: | ServiceTemplate |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServicingOrder
コンピューター層またはアプリケーション ホストが処理される順序を指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Site
関連付けられている Web 展開パッケージの展開先となる Web サイトを指定します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
指定したタグのセットを持つすべてのオブジェクトを検索できるように、オブジェクトに関連付ける単語または語句を指定します。 タグのサブセットを検索することも、タグの完全なセットを検索することもできます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebApplicationHost
アプリケーション ホスト テンプレートを Web アプリケーション ホストに使用することを指定します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
出力
ApplicationHostTemplate
このコマンドレットは 、ApplicationHostTemplate オブジェクトを返します。