Compartir a través de

Reset-AzureRoleInstance

  • Referencia
Módulo:
Azure

Solicita un reinicio o una imagen de imagen de una sola instancia de rol o de todas las instancias de rol de un rol específico.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

Description

El cmdlet Reset-AzureRoleInstance solicita un reinicio o una imagen nueva de una instancia de rol que se ejecuta en una implementación. Esta operación se ejecuta sincrónicamente. Al reiniciar una instancia de rol, Azure desconecta la instancia, reinicia el sistema operativo subyacente para esa instancia y vuelve a conectar la instancia. Los datos que se escriben en el disco local se conservan en los reinicios. Se pierden los datos que están en memoria.

Restablecer la imagen de una instancia de rol da como resultado un comportamiento diferente en función del tipo de rol. En el caso de un rol web o de trabajo, cuando se vuelve a crear la imagen del rol, Azure desconecta el rol y escribe una instalación nueva del sistema operativo invitado de Azure en la máquina virtual. El rol se vuelve a poner en línea. En el caso de un rol de máquina virtual, cuando el rol se vuelve a crear una imagen de imagen, Azure vuelve a estar sin conexión, vuelve a generar la imagen personalizada que proporcionó y vuelve a conectar el rol.

Azure intenta mantener los datos en cualquier recurso de almacenamiento local cuando se vuelve a crear la imagen del rol; sin embargo, en caso de un error transitorio de hardware, se puede perder el recurso de almacenamiento local. Si la aplicación requiere que los datos persistan, se recomienda escribir en un origen de datos duradero, como una unidad de Azure. Los datos que se escriben en un directorio local distinto del definido por el recurso de almacenamiento local se perderán cuando se vuelva a crear la imagen del rol.

Ejemplos

Ejemplo 1: Reinicio de una instancia de rol

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

Este comando reinicia la instancia de rol denominada MyWebRole_IN_0 en la implementación provisional del servicio MySvc01.

Ejemplo 2: Cambiar la imagen de una instancia de rol

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

Este comando restablece la imagen de las instancias de rol en la implementación provisional del servicio en la nube MySvc01.

Ejemplo 3: Volver a crear una imagen de todas las instancias de rol

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

Este comando vuelve a crear imágenes de todas las instancias de rol en la implementación de producción del servicio MySvc01.

Parámetros

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstanceName

Especifica el nombre de la instancia de rol que se va a restablecer o reiniciar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Reboot

Especifica que este cmdlet reinicia la instancia de rol especificada o, si no se especifica ninguna, todas las instancias de rol. Debe incluir un parámetro Reboot o Reimage , pero no ambos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Reimage

Especifica que este cmdlet vuelve a crear la imagen de la instancia de rol especificada o, si no se especifica ninguna, todas las instancias de rol. Debe incluir un parámetro Reboot o Reimage , pero no ambos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServiceName

Especifica el nombre del servicio.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Slot

Especifica el entorno de implementación donde se ejecutan las instancias de rol. Los valores válidos son: Producción y ensayo. Puede incluir el parámetro DeploymentName o Slot , pero no ambos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False