Set-SCApplicationProfile

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

アプリケーション プロファイルのプロパティを変更します。

構文

Set-SCApplicationProfile
   [-VMMServer <ServerConnection>]
   [-ApplicationProfile] <ApplicationProfile>
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-Tag <String>]
   [-CompatibilityType <String>]
   [-EnforceCompatibilityType]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCApplicationProfile コマンドレットは、アプリケーション プロファイルのプロパティを変更します。

例

例 1: アプリケーション プロファイルの名前を変更する

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> Set-SCApplicationProfile -ApplicationProfile $AppProfile -Name "StockWebApp"

最初のコマンドは、SvcWebAppProfile01 という名前のアプリケーション プロファイル オブジェクトを取得し、$AppProfile変数にオブジェクトを格納します。

2 番目のコマンドは、$AppProfileに格納されているアプリケーション プロファイル オブジェクトの名前を StockWebApp に変更します。

例 2: アプリケーション プロファイルの説明を変更する

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "StockWebApp"
PS C:\> Set-SCApplicationProfile -ApplicationProfile $AppProfile -Description "Application profile to use when deploying the stock application web servers."

最初のコマンドは、StockWebApp という名前のアプリケーション プロファイル オブジェクトを取得し、$AppProfile変数にオブジェクトを格納します。

2 番目のコマンドは、$AppProfileに格納されているアプリケーション プロファイル オブジェクトの説明を "ストック アプリケーション Web サーバーをデプロイするときに使用するアプリケーション プロファイル" に変更します。

パラメーター

-ApplicationProfile

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

Type:ApplicationProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
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: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

-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