Get-AzureRole
Microsoft Azure 서비스의 역할 목록을 반환합니다.
참고
이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.
Syntax
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
- 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 |
-InstanceDetails
이 cmdlet은 각 역할의 인스턴스에 대한 세부 정보를 반환합니다.
Type: | SwitchParameter |
Position: | 3 |
Default value: | None |
Required: | False |
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 |
-RoleName
가져올 역할의 이름을 지정합니다.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Azure 서비스의 이름을 지정합니다.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Azure 배포 환경을 지정합니다. 이 매개 변수에 허용되는 값은 프로덕션 또는 스테이징입니다.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |