Partilhar via

Reset-AzureRoleInstance

  • Referência
Módulo:
Azure

Solicita uma reinicialização ou reimagem de uma única instância de função ou de todas as instâncias de função de uma função específica.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado 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 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 criação de imagens 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. O papel é então colocado novamente 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 quaisquer recursos de armazenamento local quando a função é recriada; No entanto, em caso de falha transitória de hardware, 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

Este 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 imagem de uma instância de função

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

Este comando recria imagens 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

Este 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ção.

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

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InstanceName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServiceName

Especifica o nome do serviço.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 Preparação. Você pode incluir o parâmetro DeploymentName ou Slot , mas não ambos.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False