Condividi tramite

Reset-AzureRoleInstance

  • Riferimento
Modulo:
Azure

Richiede un riavvio o una ricreazione dell'immagine di una singola istanza del ruolo o di tutte le istanze del ruolo di un ruolo specifico.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Reset-AzureRoleInstance richiede un riavvio o una ricreazione dell'immagine di un'istanza del ruolo in esecuzione in una distribuzione. Questa operazione viene eseguita in modo sincrono. Quando si riavvia un'istanza del ruolo, Azure porta l'istanza offline, riavvia il sistema operativo sottostante per tale istanza e riporta l'istanza online. Tutti i dati scritti nel disco locale vengono mantenuti tra i riavvii. Tutti i dati in memoria vengono persi.

La ricreazione di un'istanza del ruolo comporta un comportamento diverso a seconda del tipo di ruolo. Per un ruolo Web o di lavoro, quando il ruolo viene ricreato, Azure assume il ruolo offline e scrive una nuova installazione del sistema operativo guest di Azure nella macchina virtuale. Il ruolo viene quindi riportato online. Per un ruolo macchina virtuale, quando il ruolo viene ricreato l'immagine, Azure accetta il ruolo offline, riapplica l'immagine personalizzata fornita e riporta il ruolo online.

Azure tenta di mantenere i dati in qualsiasi risorsa di archiviazione locale quando viene ricreata l'immagine del ruolo; Tuttavia, in caso di errore hardware temporaneo, la risorsa di archiviazione locale potrebbe essere persa. Se l'applicazione richiede che i dati vengano mantenuti, è consigliabile scrivere in un'origine dati durevole, ad esempio un'unità di Azure. Tutti i dati scritti in una directory locale diversa da quella definita dalla risorsa di archiviazione locale andranno persi quando viene ricreata l'immagine del ruolo.

Esempio

Esempio 1: Riavviare un'istanza del ruolo

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

Questo comando riavvia l'istanza del ruolo denominata MyWebRole_IN_0 nella distribuzione di staging del servizio MySvc01.

Esempio 2: Ricreazione dell'immagine di un'istanza del ruolo

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

Questo comando ricrea l'immagine delle istanze del ruolo nella distribuzione di staging del servizio cloud MySvc01.

Esempio 3: Ricreazione dell'immagine di tutte le istanze del ruolo

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

Questo comando ricrea l'immagine di tutte le istanze del ruolo nella distribuzione di produzione del servizio MySvc01.

Parametri

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InstanceName

Specifica il nome dell'istanza del ruolo da ricreare o riavviare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Reboot

Specifica che questo cmdlet riavvia l'istanza del ruolo specificata o, se non è specificato alcun valore, tutte le istanze del ruolo. È necessario includere un parametro Reboot o Reimage , ma non entrambi.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Reimage

Specifica che questo cmdlet ricrea l'immagine dell'istanza del ruolo specificata o, se non è specificato alcun valore, tutte le istanze del ruolo. È necessario includere un parametro Reboot o Reimage , ma non entrambi.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceName

Specifica il nome del server.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Slot

Specifica l'ambiente di distribuzione in cui vengono eseguite le istanze del ruolo. I valori validi sono: Produzione e Gestione temporanea. È possibile includere il parametro DeploymentName o Slot , ma non entrambi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False