Reset-AzureRoleInstance
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 de Azure heredados que usan las API de Azure Service Management (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 de 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" -RebootEste 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" -ReimageEste 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" -ReimageEste 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
- Ignore
- Inquire
- SilentlyContinue
- Detención
- 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 |