다음을 통해 공유


Get-AzApiManagementUser

사용자 또는 사용자를 가져옵니다.

구문

Get-AzApiManagementUser
   -Context <PsApiManagementContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzApiManagementUser
   -Context <PsApiManagementContext>
   [-UserId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzApiManagementUser
   -Context <PsApiManagementContext>
   [-FirstName <String>]
   [-LastName <String>]
   [-State <PsApiManagementUserState>]
   [-Email <String>]
   [-GroupId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

지정된 사용자가 없는 경우 Get-AzApiManagementUser cmdlet은 지정된 사용자 또는 모든 사용자를 가져옵니다.

예제

예제 1: 모든 사용자 가져오기

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

이 명령은 모든 사용자를 가져옵니다.

예제 2: ID로 사용자 가져오기

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

이 명령은 ID로 사용자를 가져옵니다.

예제 3: 성을 사용하여 사용자 가져오기

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Get-AzApiManagementUser -Context $apimContext -LastName "Fuller"

이 명령은 지정된 성인 Fuller를 가진 사용자를 가져옵니다.

예제 4: 전자 메일 주소로 사용자 가져오기

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Get-AzApiManagementUser -Context $apimContext -Email "user@contoso.com"

이 명령은 지정된 전자 메일 주소가 있는 사용자를 가져옵니다.

예제 5: 그룹 내의 모든 사용자 가져오기

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

이 명령은 지정된 그룹 내의 모든 사용자를 가져옵니다.

매개 변수

-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

-Email

사용자의 전자 메일 주소를 지정합니다. 이 매개 변수를 지정하면 이 cmdlet은 전자 메일로 사용자를 찾습니다. 이 매개 변수는 선택 사항입니다.

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

-FirstName

사용자의 이름을 지정합니다. 이 매개 변수를 지정하면 이 cmdlet은 이름으로 사용자를 찾습니다. 이 매개 변수는 선택 사항입니다.

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

-GroupId

그룹 식별자를 지정합니다. 지정된 경우 이 cmdlet은 지정된 그룹 내의 모든 사용자를 찾습니다. 이 매개 변수는 선택 사항입니다.

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

-LastName

사용자의 성을 지정합니다. 지정된 경우 이 cmdlet은 성으로 사용자를 찾습니다. 이 매개 변수는 선택 사항입니다.

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

-State

사용자 상태를 지정합니다. 지정된 경우 이 cmdlet은 이 상태에서 사용자를 찾습니다. 이 매개 변수는 선택 사항입니다.

형식:Nullable<T>[PsApiManagementUserState]
허용되는 값:Active, Blocked, Deleted, Pending
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-UserId

사용자 ID를 지정합니다. 지정된 경우 이 cmdlet은 이 식별자를 통해 사용자를 찾습니다. 이 매개 변수는 선택 사항입니다.

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

입력

PsApiManagementContext

String

Nullable<T>[[Microsoft.Azure.Commands.ApiManagement.ServiceManagement.Models.PsApiManagementUserState, Microsoft.Azure.PowerShell.Cmdlets.ApiManagement.ServiceManagement, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

출력

PsApiManagementUser