Sdílet prostřednictvím

Reset-AzureRoleInstance

  • Reference
Modul:
Azure

Vyžaduje restartování nebo opětovné vytvoření instance jedné role nebo všech instancí rolí konkrétní role.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

Reset-AzureRoleInstance
     [-ServiceName] <String>
     -Slot <String>
     -InstanceName <String>
     [-Reboot]
     [-Reimage]
     [-Profile <AzureSMProfile>]
     [-InformationAction <ActionPreference>]
     [-InformationVariable <String>]
     [<CommonParameters>]

Description

Rutina Reset-AzureRoleInstance vyžaduje restartování nebo opětovné sestavení instance role, která běží v nasazení. Tato operace se provede synchronně. Když instanci role restartujete, Azure tuto instanci přenese do offline režimu, restartuje základní operační systém pro danou instanci a vrátí instanci zpět do režimu online. Všechna data zapsaná na místní disk se zachovají při restartování. Všechna data, která jsou v paměti, se ztratí.

Opětovné vytvoření instance role vede k různým chováním v závislosti na typu role. V případě webové role nebo role pracovního procesu, když je role znovu zmage, Azure roli přenese do offline režimu a zapíše do virtuálního počítače novou instalaci hostovaného operačního systému Azure. Role se pak vrátí do online režimu. Pokud se role virtuálního počítače znovu zmagí role obnoví, Azure tuto roli přenese do offline režimu, znovu zobrazí vlastní image, kterou jste pro ni zadali, a role se vrátí do online režimu.

Azure se pokusí udržovat data v jakýchkoli prostředcích místního úložiště při opětovném vytvoření role; V případě přechodného selhání hardwaru však může dojít ke ztrátě místního prostředku úložiště. Pokud vaše aplikace vyžaduje trvalé uchovávání dat, doporučuje se zápis do odolného zdroje dat, jako je jednotka Azure. Všechna data zapsaná do jiného místního adresáře, než která je definována prostředkem místního úložiště, budou při obnovení role ztracena.

Příklady

Příklad 1: Restartování instance role

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -InstanceName "MyWebRole_IN_0" -Reboot

Tento příkaz restartuje instanci role s názvem MyWebRole_IN_0 v přípravném nasazení služby MySvc01.

Příklad 2: Opětovné vytvoření instance role

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

Tento příkaz znovu nastaví instance rolí v přípravném nasazení cloudové služby MySvc01.

Příklad 3: Přemísťování všech instancí rolí

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

Tento příkaz znovu napodobí všechny instance rolí v produkčním nasazení služby MySvc01.

Parametry

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

  • Pokračovat
  • Ignorovat
  • Informovat se
  • SilentlyContinue
  • Zastavit
  • Suspend
Typ:ActionPreference
Aliasy:infa
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliasy:iv
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InstanceName

Určuje název instance role, která se má znovu vytvořit nebo restartovat.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Reboot

Určuje, že tato rutina restartuje zadanou instanci role, nebo pokud není zadána žádná, všechny instance rolí. Musíte zahrnout parametr Reboot nebo Reimage , ale ne obojí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Reimage

Určuje, že tato rutina znovu nastaví zadanou instanci role, nebo pokud není zadána žádná, všechny instance rolí. Musíte zahrnout parametr Reboot nebo Reimage , ale ne obojí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServiceName

Určuje název služby.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Slot

Určuje prostředí nasazení, ve kterém se instance rolí spouštějí. Platné hodnoty jsou: Production a Staging. Můžete zahrnout parametr DeploymentName nebo Slot , ale ne obojí.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False