Share via

Reset-AzureRoleInstance

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

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

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

-InstanceName

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

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

-Profile

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

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

-Reboot

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

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

-Reimage

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

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

-ServiceName

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

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

-Slot

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

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