다음을 통해 공유


Get-AzApiManagementGroup

모든 또는 특정 API 관리 그룹을 가져옵니다.

구문

Get-AzApiManagementGroup
   -Context <PsApiManagementContext>
   [-Name <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzApiManagementGroup
   -Context <PsApiManagementContext>
   [-GroupId <String>]
   [-Name <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzApiManagementGroup
   -Context <PsApiManagementContext>
   [-Name <String>]
   [-UserId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzApiManagementGroup
   -Context <PsApiManagementContext>
   [-Name <String>]
   [-ProductId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzApiManagementGroup cmdlet은 모든 또는 특정 API 관리 그룹을 가져옵니다.

예제

예제 1: 모든 그룹 가져오기

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Get-AzApiManagementGroup -Context $apimContext

이 명령은 모든 그룹을 가져옵니다.

예제 2: ID로 그룹 가져오기

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Get-AzApiManagementGroup -Context $apimContext -GroupId "0123456789"

이 명령은 0123456789 그룹 ID를 가져옵니다.

예제 3: 이름으로 그룹 가져오기

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Get-AzApiManagementGroup -Context $apimContext -Name "Group0002"

이 명령은 Group0002라는 그룹을 가져옵니다.

예제 4: 모든 사용자 그룹 가져오기

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Get-AzApiManagementGroup -Context $apimContext -UserId "0123456789"

이 명령은 이름이 0123456789 사용자 ID를 가진 모든 사용자 그룹을 가져옵니다.

매개 변수

-Context

PsApiManagementContext의 인스턴스를 지정합니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-GroupId

그룹 ID를 지정합니다. 지정된 경우 cmdlet은 식별자를 통해 그룹을 찾으려고 시도합니다.

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

-Name

관리 그룹의 이름을 지정합니다.

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

-ProductId

기존 제품의 식별자입니다. 지정된 경우 제품이 할당된 모든 그룹을 반환합니다. 이 매개 변수는 선택 사항입니다.

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

-UserId

기존 제품의 식별자를 지정합니다. 지정된 경우 cmdlet은 제품이 할당된 모든 그룹을 반환합니다.

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

입력

PsApiManagementContext

String

출력

PsApiManagementGroup