Reset-AzureRoleInstance

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

1 つのロール インスタンスまたは特定のロールのすべてのロール インスタンスの再起動または再イメージ化を要求します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Reset-AzureRoleInstance
     [-ServiceName] <String>
     -Slot <String>
     -InstanceName <String>
     [-Reboot]
     [-Reimage]
     [-Profile <AzureSMProfile>]
     [-InformationAction <ActionPreference>]
     [-InformationVariable <String>]
     [<CommonParameters>]

説明

Reset-AzureRoleInstance コマンドレットは、デプロイで実行されているロール インスタンスの再起動または再イメージ化を要求します。 この操作は同期的に実行されます。 ロール インスタンスを再起動すると、Azure はインスタンスをオフラインにし、そのインスタンスの基になるオペレーティング システムを再起動して、インスタンスをオンラインに戻します。 ローカル ディスクに書き込まれるデータは、再起動後も保持されます。 メモリ内にあるデータはすべて失われます。

ロール インスタンスを再イメージ化すると、ロールの種類によって動作が異なります。 Web ロールまたは worker ロールの場合、ロールが再イメージ化されると、Azure はロールをオフラインにして、Azure ゲスト オペレーティング システムの新しいインストールを仮想マシンに書き込みます。 その後、ロールはオンラインに戻されます。 VM ロールの場合、ロールが再イメージ化されると、Azure はロールをオフラインにし、指定したカスタム イメージを再び取得し、ロールをオンラインに戻します。

Azure は、ロールが再イメージ化されるときに、ローカル ストレージ リソース内のデータを維持しようとします。ただし、一時的なハードウェア障害が発生した場合、ローカル ストレージ リソースが失われる可能性があります。 アプリケーションでデータを永続化する必要がある場合は、Azure ドライブなどの永続的なデータ ソースへの書き込みが推奨されます。 ローカル ストレージ リソースによって定義されているデータ以外のローカル ディレクトリに書き込まれるデータは、ロールの再イメージ化時に失われます。

例

例 1: ロール インスタンスを再起動する

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -InstanceName "MyWebRole_IN_0" -Reboot

このコマンドは、MySvc01 サービスのステージングデプロイでMyWebRole_IN_0という名前のロール インスタンスを再起動します。

例 2: ロール インスタンスを再イメージ化する

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -Reimage

このコマンドは、MySvc01 クラウド サービスのステージング デプロイのロール インスタンスを再イメージ化します。

例 3: すべてのロール インスタンスを再イメージ化する

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc1" -Slot "Production" -Reimage

このコマンドは、MySvc01 サービスの運用デプロイ内のすべてのロール インスタンスを再イメージ化します。

パラメーター

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • [中断]
型:ActionPreference
Aliases:infa
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationVariable

情報変数を指定します。

型:String
Aliases:iv
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InstanceName

再イメージ化または再起動するロール インスタンスの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Reboot

このコマンドレットが指定したロール インスタンスを再起動するか、指定されていない場合はすべてのロール インスタンスを再起動することを指定します。 Reboot パラメーターまたは Reimage パラメーターを含める必要がありますが、両方を含める必要はありません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Reimage

このコマンドレットで、指定したロール インスタンスを再イメージ化するか、指定されていない場合はすべてのロール インスタンスを再イメージ化することを指定します。 Reboot パラメーターまたは Reimage パラメーターを含める必要がありますが、両方を含める必要はありません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServiceName

サービスの名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Slot

ロール インスタンスが実行されるデプロイ環境を指定します。 有効な値は、運用とステージングです。 DeploymentName パラメーターまたは Slot パラメーターを含めることができますが、両方を含めることもできます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False