Set-SCApplicationHostTemplate
サービス テンプレートに追加されたアプリケーション ホスト テンプレートのプロパティを構成します。
構文
Set-SCApplicationHostTemplate
[-DeploymentOrder <Int32>]
[-ServicingOrder <Int32>]
[-Port <Int32>]
[-AllowUntrustedServerCertificate <Boolean>]
[-RunAsAccount <VMMCredential>]
[-ApplicationHostTemplate] <ApplicationHostTemplate>
[-Name <String>]
[-Description <String>]
[-Owner <String>]
[-Tag <String>]
[-ComputerName <String>]
[-Site <String>]
[-AuthenticationType <String>]
[-ApplicationProfile <ApplicationProfile>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] 説明
Set-SCApplicationHostTemplate コマンドレットは、サービス テンプレートに追加されたアプリケーション ホスト テンプレートのプロパティを構成します。
例
例 1: アプリケーション ホスト テンプレートの説明を変更する
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $AppHostTemplate = Get-SCApplicationHostTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCApplicationHostTemplate -ApplicationHostTemplate $AppHostTemplate -Description "This is the updated description"最初のコマンドは、ServiceTemplate01 という名前のサービス テンプレート オブジェクトを取得し、$ServiceTemplate変数にオブジェクトを格納します。
2 番目のコマンドは、$ServiceTemplate内のサービス テンプレートのアプリケーション ホスト テンプレート オブジェクトを取得し、$AppHostTemplate変数にオブジェクトを格納します。
最後のコマンドは、$AppHostTemplateのアプリケーション ホスト テンプレートの description プロパティを変更します。
例 2: アプリケーション ホスト テンプレートの名前を変更する
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $AppHostTemplate = Get-SCApplicationHostTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCApplicationHostTemplate -ApplicationHostTemplate $AppHostTemplate -Name "This is the updated name"最初のコマンドは、ServiceTemplate01 という名前のサービス テンプレート オブジェクトを取得し、$ServiceTemplate変数にオブジェクトを格納します。
2 番目のコマンドは、$ServiceTemplateに格納されているサービス テンプレートのアプリケーション ホスト テンプレート オブジェクトを取得し、$AppHostTemplate変数にオブジェクトを格納します。
最後のコマンドは、$AppHostTemplateに格納されているアプリケーション ホスト テンプレートの name プロパティを変更します。 アプリケーション ホスト テンプレートはサービス テンプレートに複製されるため、アプリケーション ホスト テンプレートの名前を変更しても、システム内の他のサービス テンプレートには影響しません。
パラメーター
-AllowUntrustedServerCertificate
ターゲット展開サーバーが信頼されていないサーバー証明書を提示したときに展開を続行できるかどうかを示します。 このパラメーターは、Web アプリケーション ホスト テンプレートと組み合わせて使用されます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationHostTemplate
アプリケーション ホスト テンプレート オブジェクトを指定します。
| Type: | ApplicationHostTemplate |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationProfile
アプリケーション プロファイル オブジェクトを指定します。
| Type: | ApplicationProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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: | False |
| 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: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller" - 形式の例:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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: | False |
| 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 |
-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: | False |
| 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 |
出力
ApplicationHostTemplate
このコマンドレットは、 ApplicationHostTemplate オブジェクトを返します。