Partager via


Reset-AzureRoleInstance

Demande un redémarrage ou une réinitialisation d’une instance de rôle unique ou de toutes les instances de rôle d’un rôle spécifique.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

Description

L’applet de commande Reset-AzureRoleInstance demande un redémarrage ou une réinitialisation d’une instance de rôle qui s’exécute dans un déploiement. Cette opération s’exécute de manière synchrone. Lorsque vous redémarrez une instance de rôle, Azure met l’instance hors connexion, redémarre le système d’exploitation sous-jacent pour cette instance et rétablit l’instance en ligne. Toutes les données écrites sur le disque local persistent au cours des redémarrages. Toutes les données en mémoire sont perdues.

La réinitialisation d’une instance de rôle entraîne un comportement différent en fonction du type de rôle. Pour un rôle web ou de travail, lorsque le rôle est réimagené, Azure prend le rôle hors connexion et écrit une nouvelle installation du système d’exploitation invité Azure sur la machine virtuelle. Le rôle est ensuite ramené en ligne. Pour un rôle de machine virtuelle, lorsque le rôle est réimagené, Azure prend le rôle hors connexion, réapplique l’image personnalisée que vous lui avez fournie et rétablit le rôle en ligne.

Azure tente de conserver des données dans toutes les ressources de stockage locales lorsque le rôle est réimagené ; toutefois, en cas de défaillance matérielle temporaire, la ressource de stockage locale peut être perdue. Si votre application nécessite que les données persistent, l’écriture dans une source de données durable, telle qu’un lecteur Azure, est recommandée. Toutes les données écrites dans un répertoire local autre que celui défini par la ressource de stockage locale seront perdues lorsque le rôle est réimagené.

Exemples

Exemple 1 : Redémarrer une instance de rôle

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

Cette commande redémarre l’instance de rôle nommée MyWebRole_IN_0 dans le déploiement intermédiaire du service MySvc01.

Exemple 2 : Réinitialisation d’une instance de rôle

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

Cette commande réimage les instances de rôle dans le déploiement intermédiaire du service cloud MySvc01.

Exemple 3 : Réimager toutes les instances de rôle

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

Cette commande réimage toutes les instances de rôle dans le déploiement de production du service MySvc01.

Paramètres

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Alias:iv
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InstanceName

Spécifie le nom de l’instance de rôle à réimager ou redémarrer.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Reboot

Spécifie que cette applet de commande redémarre l’instance de rôle spécifiée ou, si aucune n’est spécifiée, toutes les instances de rôle. Vous devez inclure un paramètre Reboot ou Reimage , mais pas les deux.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Reimage

Spécifie que cette applet de commande réimage l’instance de rôle spécifiée ou, si aucune n’est spécifiée, toutes les instances de rôle. Vous devez inclure un paramètre Reboot ou Reimage , mais pas les deux.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServiceName

Spécifie le nom du service.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Slot

Spécifie l’environnement de déploiement dans lequel les instances de rôle s’exécutent. Les valeurs valides sont : Production et préproduction. Vous pouvez inclure le paramètre DeploymentName ou Slot , mais pas les deux.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False