共用方式為

Reset-AzureRoleInstance

  • 參考
模組:
Azure

要求重新啟動或重新映像單一角色實例或特定角色的所有角色實例。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

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

Description

Reset-AzureRoleInstance Cmdlet 會要求重新啟動或重新安裝部署中執行的角色實例映射。 這項作業會同步執行。 當您重新啟動角色實例時，Azure 會讓實例脫機、重新啟動該實例的基礎操作系統，並將實例重新上線。 寫入本機磁碟的任何數據會在重新啟動時保存。 記憶體內的任何數據都遺失。

重新製作角色實例的映像會導致不同的行為，視角色類型而定。 針對 Web 或背景工作角色，當角色重新製作映像時，Azure 會讓角色離線，並將 Azure 客體作業系統的全新安裝寫入虛擬機。 然後角色會重新上線。 針對 VM 角色，當角色重新映射時，Azure 會讓角色離線、重新套用您為其提供的自定義映像，並將角色重新上線。

Azure 會在重新映射角色時，嘗試維護任何本機記憶體資源中的數據;不過，如果暫時性硬體故障，本機記憶體資源可能會遺失。 如果您的應用程式需要保存該數據，建議寫入永久性數據源，例如 Azure 磁碟驅動器。 當重新映像角色時，寫入本機記憶體資源所定義的本機目錄以外的任何數據都會遺失。

範例

範例 1：重新啟動角色實例

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

此命令會在 MySvc01 服務的預備部署中重新啟動名為 MyWebRole_IN_0 的角色實例。

範例 2：重新設定角色實例的映像

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

此命令會在 MySvc01 雲端服務的預備部署中重新設定角色實例的映像。

範例 3：重新映像所有角色實例

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

此命令會重新映像 MySvc01 服務生產部署中的所有角色實例。

參數

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

類型:String
別名:iv
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InstanceName

指定要重新產生映像或重新啟動的角色實例名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Reboot

指定此 Cmdlet 會重新啟動指定的角色實例，如果未指定任何角色實例，則為所有角色實例。 您必須包含 Reboot 或 Reimage 參數，但不能同時包含這兩個參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Reimage

指定此 Cmdlet 會重新映像指定的角色實例，如果未指定，則為所有角色實例。 您必須包含 Reboot 或 Reimage 參數，但不能同時包含這兩個參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServiceName

指定服務的名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Slot

指定角色實例執行所在的部署環境。 有效值為：生產與預備。 您可以包含 DeploymentName 或 Slot 參數，但不能同時包含這兩者。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False