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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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:

Fortfahren
Ignorieren
Fragen
SilentlyContinue
Beenden
Angehalten

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Gibt eine Informationsvariable an.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

Gibt den Namen des Diensts an.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Set-AzureRole