Reset-AzureRoleInstance

Referência

Módulo:: Azure

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

Set-AzureRole