Add-SCApplicationHostTemplate
將應用程式主機範本新增至服務範本。
Syntax
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>]
Description
Add-SCApplicationHostTemplate Cmdlet 會將應用程式主機範本新增至服務範本。 應用程式主機範本可用來將 SQL 資料層應用程式 (DAC) 部署在已部署的 SQL Server 或 Web Deploy 套件上部署到支援的 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變數中。
第二個命令會取得名為 ServiceTemplate01 的服務 temnplate 物件,並將物件儲存在$ServiceTemplate變數中。
第三個命令會將應用程式主機範本新增至儲存在 $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變數中。
第二個命令會取得名為 ServiceTemplate01 的服務範本物件,並將物件儲存在$ServiceTemplate變數中。
第三個命令會取得名為 IIS 網站管理員的執行身分帳戶物件,並將物件儲存在$WebRAA變數中。
最後一個命令會將 Web 應用程式主機範本新增至儲存在 $ServiceTemplate (的服務範本,在此案例中為 ServiceTemplate01) 。
參數
-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
指定 Virtual Machine Manager (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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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 應用程式主機範本搭配使用。
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
此 Cmdlet 會傳回 ApplicationHostTemplate 物件。