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 |