다음을 통해 공유


Get-AzureRole

Microsoft Azure 서비스의 역할 목록을 반환합니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

Get-AzureRole
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-RoleName] <String>]
   [-InstanceDetails]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Get-AzureRole cmdlet은 Microsoft Azure 서비스의 역할에 대한 세부 정보가 포함된 목록 개체를 반환합니다. RoleName 매개 변수지정하는 경우 Get-AzureRole은 해당 역할에 대한 세부 정보만 반환합니다. InstanceDetails 매개 변수를 지정하면 인스턴스별 추가 세부 정보가 반환됩니다.

예제

예제 1: 서비스에 대한 역할 목록 가져오기

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production"

이 명령은 MySvc01 서비스에서 실행되는 모든 프로덕션 역할에 대한 세부 정보가 포함된 개체를 반환합니다.

예제 2: 서비스에서 실행되는 역할에 대한 세부 정보 가져오기

PS C:\> Get-AzureRole -ServiceName "MySvc1" -Slot "Staging" -RoleName "MyTestVM3"

이 명령은 MySvc01 서비스의 스테이징 환경에서 실행되는 MyTestVM3 역할에 대한 세부 정보가 포함된 개체를 반환합니다.

예제 3: 서비스에서 실행되는 역할의 인스턴스에 대한 인스턴스 정보 가져오기

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestVM02" -InstanceDetails

이 명령은 MySvc01 서비스의 프로덕션 환경에서 실행되는 MyTestVM02 역할의 인스턴스에 대한 세부 정보가 포함된 개체를 반환합니다.

예제 4: 서비스와 연결된 역할 인스턴스의 테이블 가져오기

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -InstanceDetails | Format-Table -Auto "InstanceName", "InstanceSize", "InstanceStatus"

이 명령은 MySvc01 서비스의 프로덕션 환경에서 실행되는 모든 역할 인스턴스의 인스턴스 이름, 크기 및 상태 테이블을 반환합니다.

매개 변수

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 묻다
  • SilentlyContinue
  • 중지
  • 일시 중단됨
형식:ActionPreference
별칭:infa
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InformationVariable

정보 변수를 지정합니다.

형식:String
별칭:iv
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InstanceDetails

이 cmdlet은 각 역할의 인스턴스에 대한 세부 정보를 반환합니다.

형식:SwitchParameter
Position:3
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Profile

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

형식:AzureSMProfile
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RoleName

가져올 역할의 이름을 지정합니다.

형식:String
Position:2
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServiceName

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

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Slot

Azure 배포 환경을 지정합니다. 이 매개 변수에 허용되는 값은 프로덕션 또는 스테이징입니다.

형식:String
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False