New-SCApplicationProfile
構文
Default (既定)
New-SCApplicationProfile
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-Owner <String>]
[-UserRole <UserRole>]
[-Tag <String>]
[-CompatibilityType <String>]
[-EnforceCompatibilityType]
[-ApplicationProfile <ApplicationProfile>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
New-SCApplicationProfile コマンドレットは、アプリケーション プロファイルを作成します。
アプリケーション・プロファイルは、仮想マシンのデプロイメントおよびサービス中にインストールされるアプリケーションを定義します。
例
例 1: アプリケーションプロファイルを作成する
PS C:\> $AppProfile = New-SCApplicationProfile -Name "SvcWebAppProfile01" -Owner "Contoso\Katarina"
PS C:\> $AppProfile
最初のコマンドは、SvcWebAppProfile01 という名前のアプリケーション プロファイル オブジェクトを作成し、そのオブジェクトを $AppProfile 変数に格納します。
2 番目の画面は、$AppProfile に保存されているアプリケーション プロファイルに関する情報をユーザーに表示します。
例 2: 既存のプロファイルをクローニングしてアプリケーションプロファイルを作成する
PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $AppProfile02 = New-SCApplicationProfile -Name "SvcWebAppProfile02" -ApplicationProfile $AppProfile
最初のコマンドは、SvcWebAppProfile01 という名前のアプリケーション プロファイル オブジェクトを取得し、そのオブジェクトを $AppProfile 変数に格納します。
2 番目のコマンドは、$AppProfile (SvcWebAppProfile01) に格納されているアプリケーション プロファイルを複製して、SvcWebAppProfile02 という名前のアプリケーション プロファイルを作成します。
パラメーター
-ApplicationProfile
アプリケーション プロファイル オブジェクトを指定します。
パラメーターのプロパティ
| 型: | ApplicationProfile
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CompatibilityType
アプリケーション・プロファイルと互換性があるデプロイメント・タイプを指定します。
有効な値は次のとおりです。
- 全般
- SQLApplicationHost (英語)
- Webアプリケーションホスト
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
アプリケーションプロファイルの説明を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EnforceCompatibilityType
CompatibilityType パラメーターに指定された値と互換性のないアプリケーション プロファイルの成果物が削除されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-JobVariable
ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
Virtual Machine Manager (VMM) オブジェクトの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller"
- 形式の例:
-Owner "PattiFuller@Contoso"
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。
このパラメーターを使用すると、PRO のヒントを監査できます。
パラメーターのプロパティ
| 型: | Guid
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Tag
オブジェクトに関連付ける単語または語句を指定して、指定したタグのセットを持つすべてのオブジェクトを検索できるようにします。
タグのサブセットを検索することも、タグの完全なセットを検索することもできます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserRole
ユーザー ロール オブジェクトを指定します。
パラメーターのプロパティ
| 型: | UserRole
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
パラメーターのプロパティ
| 型: | ServerConnection
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
ApplicationProfile
このコマンドレットは、 ApplicationProfile オブジェクトを返します。