Reset-AzureRoleInstance

Módulo:

Azure

Solicita uma reinicialização ou recriação 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 referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 nova imagem de uma instância de função que está sendo executada em uma implantação. Essa 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 para essa 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 uma instância de função resulta em um 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. A função é então colocada online novamente. Para uma função de 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 transitória de hardware, o recurso de armazenamento local pode ser perdido. Se o 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 uma instância de função

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

Esse comando recria a imagem das instâncias de função na implantação de preparo do serviço de nuvem MySvc01.

Exemplo 3: Recriar todas as instâncias de função

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

Esse comando recria 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ção.

Os valores aceitáveis para esse parâmetro são:

• Continuar
• Ignorar
• Perguntar
• SilentlyContinue
• Stop
• Suspend

Tipo:	ActionPreference
Aliases:	infa
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InformationVariable

Especifica uma variável de informação.

Tipo:	String
Aliases:	iv
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InstanceName

Especifica o nome da instância de função a ser recriada ou reinicializada.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:	AzureSMProfile
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Reimage

Especifica que esse cmdlet recria a imagem da 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.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ServiceName

Especifica o nome do serviço.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Slot

Especifica o ambiente de implantação em que as instâncias de função são executadas. Os valores válidos são: Produção e Preparação. Você pode incluir o parâmetro DeploymentName ou Slot , mas não ambos.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

Links Relacionados

• Set-AzureRole