Freigeben über

Reset-AzureRoleInstance

  • Referenz
Modul:
Azure

Fordert einen Neustart oder ein Erneutes Image einer einzelnen Rolleninstanz oder aller Rolleninstanzen einer bestimmten Rolle an.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Reset-AzureRoleInstance fordert einen Neustart oder eine Neuimage einer Rolleninstanz an, die in einer Bereitstellung ausgeführt wird. Dieser Vorgang wird synchron ausgeführt. Wenn Sie eine Rolleninstanz neu starten, nimmt Azure die Instanz offline, startet das zugrunde liegende Betriebssystem für diese Instanz neu und bringt die Instanz wieder online. Alle Daten, die auf den lokalen Datenträger geschrieben werden, werden über Neustarts hinweg beibehalten. Alle Daten, die im Arbeitsspeicher gespeichert sind, gehen verloren.

Das Reimaging einer Rolleninstanz führt je nach Rollentyp zu unterschiedlichem Verhalten. Bei einer Web- oder Arbeitsrolle übernimmt Azure die Rolle offline und schreibt eine Neuinstallation des Azure-Gastbetriebssystems auf den virtuellen Computer. Die Rolle wird dann wieder online gebracht. Bei einer VM-Rolle übernimmt Azure die Rolle offline, wendet das von Ihnen bereitgestellte benutzerdefinierte Image erneut an und bringt die Rolle wieder online.

Azure versucht, Daten in allen lokalen Speicherressourcen zu verwalten, wenn die Rolle neu abbilden wird; Im Falle eines vorübergehenden Hardwarefehlers kann die lokale Speicherressource jedoch verloren gehen. Wenn Ihre Anwendung diese Daten beibehalten muss, empfiehlt es sich, in eine dauerhafte Datenquelle zu schreiben, z. B. ein Azure-Laufwerk. Alle Daten, die in ein anderes als das von der lokalen Speicherressource definierte lokale Verzeichnis geschrieben werden, gehen verloren, wenn die Rolle neu inimages erstellt wird.

Beispiele

Beispiel 1: Neustart einer Rolleninstanz

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

Mit diesem Befehl wird die Rolleninstanz namens MyWebRole_IN_0 in der Stagingbereitstellung des MySvc01-Diensts neu gestartet.

Beispiel 2: Erneutes Abbilden einer Rolleninstanz

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

Dieser Befehl stellt die Rolleninstanzen in der Stagingbereitstellung des MySvc01-Clouddiensts neu her.

Beispiel 3: Erneutes Abbilden aller Rolleninstanzen

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

Mit diesem Befehl werden alle Rolleninstanzen in der Produktionsbereitstellung des MySvc01-Diensts neu abbildet.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceName

Gibt den Namen der Rolleninstanz an, um das Image oder den Neustart neu zu starten.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Reboot

Gibt an, dass dieses Cmdlet die angegebene Rolleninstanz neu startet oder, wenn keine angegeben wird, alle Rolleninstanzen. Sie müssen entweder einen Reboot- oder reimage-Parameter, aber nicht beides einschließen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Reimage

Gibt an, dass dieses Cmdlet die angegebene Rolleninstanz neu abbildet oder, wenn keine angegeben wird, alle Rolleninstanzen. Sie müssen entweder einen Reboot- oder reimage-Parameter, aber nicht beides einschließen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den Namen des Diensts an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Slot

Gibt die Bereitstellungsumgebung an, in der die Rolleninstanzen ausgeführt werden. Gültige Werte sind: Produktion und Staging. Sie können entweder den Parameter DeploymentName oder Slot einschließen, aber nicht beide.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False