Reset-AzureRoleInstance
Solicita uma reinicialização ou recriação de imagem de uma única instância de função ou de todas as instâncias de função de uma função específica.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
Reset-AzureRoleInstance
[-ServiceName] <String>
-Slot <String>
-InstanceName <String>
[-Reboot]
[-Reimage]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet Reset-AzureRoleInstance solicita uma reinicialização ou uma reimagem de uma instância de função que está sendo executada em uma implantação. Esta operação é executada de forma síncrona. Quando você reinicializa uma instância de função, o Azure coloca a instância offline, reinicia o sistema operacional subjacente dessa instância e coloca a instância online novamente. Todos os dados gravados no disco local persistem nas reinicializações. Todos os dados que estão na memória são perdidos.
A recriação de imagens de uma instância de função resulta em comportamento diferente, dependendo do tipo de função. Para uma função Web ou de trabalho, quando a função é recriada, o Azure coloca a função offline e grava uma nova instalação do sistema operacional convidado do Azure na máquina virtual. O papel é então trazido de volta online. Para uma função VM, quando a função é recriada, o Azure coloca a função offline, reaplica a imagem personalizada que você forneceu para ela e coloca a função online novamente.
O Azure tenta manter dados em qualquer recurso de armazenamento local quando a função é recriada; no entanto, no caso de uma falha de hardware transitória, o recurso de armazenamento local pode ser perdido. Se seu aplicativo exigir que os dados persistam, é recomendável gravar em uma fonte de dados durável, como uma unidade do Azure. Todos os dados gravados em um diretório local diferente daquele definido pelo recurso de armazenamento local serão perdidos quando a função for recriada.
Exemplos
Exemplo 1: Reinicializar uma instância de função
PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -InstanceName "MyWebRole_IN_0" -Reboot
Esse comando reinicializa a instância de função chamada MyWebRole_IN_0 na implantação de preparo do serviço MySvc01.
Exemplo 2: Recriar a imagem de uma instância de função
PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -Reimage
Este comando recria a imagem das instâncias de função na implantação de preparo do serviço de nuvem MySvc01.
Exemplo 3: Recriar imagens de todas as instâncias de função
PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc1" -Slot "Production" -Reimage
Esse comando recria imagens de todas as instâncias de função na implantação de produção do serviço MySvc01.
Parâmetros
-InformationAction
Especifica como esse cmdlet responde a um evento de informações.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Especifica uma variável de informação.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceName
Especifica o nome da instância de função a ser recriada ou reinicializada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reboot
Especifica que esse cmdlet reinicializa a instância de função especificada ou, se nenhuma for especificada, todas as instâncias de função. Você deve incluir um parâmetro Reboot ou Reimage , mas não ambos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Reimage
Especifica que esse cmdlet recria imagens da instância de função especificada ou, se nenhuma for especificada, de todas as instâncias de função. Você deve incluir um parâmetro Reboot ou Reimage , mas não ambos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Especifica o nome do serviço.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Especifica o ambiente de implantação onde as instâncias de função são executadas. Os valores válidos são: Produção e Preparo. Você pode incluir o parâmetro DeploymentName ou Slot , mas não ambos.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |