Share via


Reset-AzureRoleInstance

단일 역할 인스턴스 또는 특정 역할의 모든 역할 인스턴스의 재부팅 또는 이미지 다시 설치를 요청합니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

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

Description

Reset-AzureRoleInstance cmdlet은 배포에서 실행 중인 역할 인스턴스의 재부팅 또는 이미지 다시 설치를 요청합니다. 이 작업은 동기적으로 실행됩니다. 역할 인스턴스를 다시 부팅하면 Azure는 인스턴스를 오프라인으로 전환하고, 해당 인스턴스에 대한 기본 운영 체제를 다시 시작하고, 인스턴스를 다시 온라인 상태로 만듭니다. 로컬 디스크에 기록된 모든 데이터는 다시 부팅 시 유지됩니다. 메모리 내의 모든 데이터가 손실됩니다.

역할 인스턴스를 이미지로 다시 설치하면 역할 유형에 따라 다른 동작이 발생합니다. 웹 또는 작업자 역할의 경우 역할이 이미지로 다시 설치되면 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
  • Stop
  • 일시 중단
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

정보 변수를 지정합니다.

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

-InstanceName

이미지로 다시 설치하거나 다시 부팅할 역할 인스턴스의 이름을 지정합니다.

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

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

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

-Reboot

이 cmdlet이 지정된 역할 인스턴스를 다시 부팅하거나, 지정되지 않은 경우 모든 역할 인스턴스를 다시 부팅되도록 지정합니다. Reboot 또는 Reimage 매개 변수를 포함해야 하지만 둘 다 포함할 수는 없습니다.

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

-Reimage

이 cmdlet은 지정된 역할 인스턴스를 이미지로 다시 설치하거나, 지정되지 않은 경우 모든 역할 인스턴스를 이미지로 표시합니다. Reboot 또는 Reimage 매개 변수를 포함해야 하지만 둘 다 포함할 수는 없습니다.

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

-ServiceName

서비스의 이름을 지정합니다.

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

-Slot

역할 인스턴스가 실행되는 배포 환경을 지정합니다. 유효한 값은 프로덕션 및 스테이징입니다. DeploymentName 또는 Slot 매개 변수를 포함할 수 있지만 둘 다 포함할 수는 없습니다.

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