Dela via

Reset-AzureRoleInstance

  • Referens
Modul:
Azure

Begär en omstart eller omimering av en enskild rollinstans eller alla rollinstanser av en viss roll.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

Syntax

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

Description

Cmdleten Reset-AzureRoleInstance begär en omstart eller en omimering av en rollinstans som körs i en distribution. Den här åtgärden körs synkront. När du startar om en rollinstans tar Azure instansen offline, startar om det underliggande operativsystemet för den instansen och gör instansen online igen. Alla data som skrivs till den lokala disken sparas mellan omstarter. Alla data som finns i minnet går förlorade.

Om du återskapar en rollinstans resulterar det i olika beteenden beroende på typen av roll. När rollen återskapas för en webb- eller arbetsroll tar Azure rollen offline och skriver en ny installation av Gästoperativsystemet i Azure till den virtuella datorn. Rollen tas sedan tillbaka online. För en vm-roll, när rollen har återskapats, tar Azure rollen offline, återskapar den anpassade avbildningen som du angav för den och för tillbaka rollen online.

Azure försöker underhålla data i alla lokala lagringsresurser när rollen har återskapats. I händelse av ett tillfälligt maskinvarufel kan dock den lokala lagringsresursen gå förlorad. Om ditt program kräver att data bevaras rekommenderar vi att du skriver till en beständig datakälla, till exempel en Azure-enhet. Alla data som skrivs till en annan lokal katalog än de som definieras av den lokala lagringsresursen går förlorade när rollen återskapas.

Exempel

Exempel 1: Starta om en rollinstans

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

Det här kommandot startar om rollinstansen med namnet MyWebRole_IN_0 i mellanlagringsdistributionen av MySvc01-tjänsten.

Exempel 2: Återskapa en rollinstans

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

Det här kommandot återskapar rollinstanserna i mellanlagringsdistributionen av MySvc01-molntjänsten.

Exempel 3: Ändra storlek på alla rollinstanser

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

Det här kommandot återskapar alla rollinstanser i produktionsdistributionen av Tjänsten MySvc01.

Parametrar

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Typ:ActionPreference
Alias:infa
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InformationVariable

Anger en informationsvariabel.

Typ:String
Alias:iv
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceName

Anger namnet på rollinstansen som ska återskapas eller startas om.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Reboot

Anger att den här cmdleten startar om den angivna rollinstansen eller, om ingen anges, alla rollinstanser. Du måste inkludera antingen parametern Reboot eller Reimage , men inte båda.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Reimage

Anger att den här cmdleten återskapar den angivna rollinstansen eller, om ingen anges, alla rollinstanser. Du måste inkludera antingen parametern Reboot eller Reimage , men inte båda.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServiceName

Anger namnet på tjänsten.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Slot

Anger den distributionsmiljö där rollinstanserna körs. Giltiga värden är: Produktion och mellanlagring. Du kan inkludera parametern DeploymentName eller Slot , men inte båda.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False