New-SCApplicationProfile

  • リファレンス
モジュール:
VirtualMachineManager

アプリケーション プロファイルを作成します。

構文

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

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

Type:ApplicationProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompatibilityType

アプリケーション プロファイルと互換性のある展開の種類を指定します。 有効な値は次のとおりです。

  • 全般
  • SQLApplicationHost
  • WebApplicationHost
Type:String
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

-EnforceCompatibilityType

CompatibilityType パラメーターに指定された値と互換性のないアプリケーション プロファイルからの成果物が削除されることを示します。

Type:SwitchParameter
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

-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

-PROTipID

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

Type:Guid
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

-Tag

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

ユーザー ロール オブジェクトを指定します。

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

ApplicationProfile

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