Dela via


Reset-AzureRoleInstance

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 är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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 godtagbara värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Anger en informationsvariabel.

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

-InstanceName

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

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

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

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

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

-ServiceName

Anger namnet på tjänsten.

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

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