Delen via

Reset-AzureRoleInstance

  • Referentie
Module:
Azure

Hiermee wordt een herstart of installatiekopie van één rolinstantie of alle rolinstanties van een specifieke rol aangevraagd.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

De cmdlet Reset-AzureRoleInstance vraagt om opnieuw opstarten of een installatiekopie van een rolinstantie die wordt uitgevoerd in een implementatie. Deze bewerking wordt synchroon uitgevoerd. Wanneer u een rolinstantie opnieuw opstart, neemt Azure het exemplaar offline, start het onderliggende besturingssysteem voor dat exemplaar opnieuw op en brengt het exemplaar weer online. Alle gegevens die naar de lokale schijf worden geschreven, blijven behouden tijdens het opnieuw opstarten. Alle gegevens die zich in het geheugen bevinden, gaan verloren.

Het opnieuw instellen van een rolinstantie resulteert in een ander gedrag, afhankelijk van het type rol. Wanneer de rol opnieuw wordt geïnstalleerd voor een web- of werkrol, wordt de rol offline gehaald en wordt een nieuwe installatie van het Azure-gastbesturingssysteem naar de virtuele machine geschreven. De rol wordt vervolgens weer online gebracht. Wanneer de rol opnieuw wordt ingesteld voor een VM-rol, wordt de rol offline gehaald in Azure, wordt de aangepaste installatiekopie die u ervoor hebt opgegeven opnieuw toegepast en wordt de rol weer online gebracht.

Azure probeert gegevens in lokale opslagresources te onderhouden wanneer de rol opnieuw wordt gemaakt; In het geval van een tijdelijke hardwarefout kan de lokale opslagresource echter verloren gaan. Als uw toepassing vereist dat gegevens behouden blijven, wordt het schrijven naar een duurzame gegevensbron, zoals een Azure-station, aanbevolen. Alle gegevens die worden geschreven naar een andere lokale map dan die die zijn gedefinieerd door de lokale opslagresource, gaan verloren wanneer de rol opnieuw wordt ingesteld.

Voorbeelden

Voorbeeld 1: Een rolinstantie opnieuw opstarten

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

Met deze opdracht wordt het rolexemplaren met de naam MyWebRole_IN_0 opnieuw opgestart in de faseringsimplementatie van de MySvc01-service.

Voorbeeld 2: Een rolinstantie opnieuw maken

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

Met deze opdracht worden de rolinstanties in de faseringsimplementatie van de MySvc01-cloudservice opnieuw in beeld gegeven.

Voorbeeld 3: Alle rolinstanties herstellen

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

Met deze opdracht worden alle rolinstanties in de productie-implementatie van de MySvc01-service opnieuw geplaatst.

Parameters

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceName

Hiermee geeft u de naam op van het rolexemplaren om de installatiekopie te herstellen of opnieuw op te starten.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Reboot

Hiermee geeft u op dat deze cmdlet het opgegeven rolexemplaren opnieuw opstart of, als er geen is opgegeven, alle rolinstanties. U moet de parameter Reboot of Reimage opnemen, maar niet beide.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Reimage

Hiermee geeft u op dat met deze cmdlet het opgegeven rolexemplaren opnieuw worden ingesteld of, als er geen is opgegeven, alle rolinstanties. U moet de parameter Reboot of Reimage opnemen, maar niet beide.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServiceName

Hiermee geeft u de naam van de service.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Slot

Hiermee geeft u de implementatieomgeving op waar de rolinstanties worden uitgevoerd. Geldige waarden zijn: Productie en Fasering. U kunt de parameter DeploymentName of Site opnemen, maar niet beide.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False