Condividi tramite

Get-AzApiManagementUser

  • Riferimento
Modulo:
Az.ApiManagement

Ottiene un utente o un utente.

Sintassi

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>]

Descrizione

Il cmdlet Get-AzApiManagementUser ottiene un utente specificato o tutti gli utenti, se non viene specificato alcun utente.

Esempio

Esempio 1: Ottenere tutti gli utenti

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

Questo comando ottiene tutti gli utenti.

Esempio 2: Ottenere un utente in base all'ID

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

Questo comando ottiene un utente in base all'ID.

Esempio 3: Ottenere gli utenti in base al cognome

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

Questo comando ottiene gli utenti con un cognome specificato, Fuller.

Esempio 4: Ottenere un utente in base all'indirizzo di posta elettronica

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

Questo comando ottiene l'utente con l'indirizzo di posta elettronica specificato.

Esempio 5: Ottenere tutti gli utenti all'interno di un gruppo

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

Questo comando ottiene tutti gli utenti all'interno del gruppo specificato.

Parametri

-Context

Specifica un'istanza di PsApiManagementContext.

Tipo:PsApiManagementContext
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Email

Specifica l'indirizzo di posta elettronica dell'utente. Se si specifica questo parametro, questo cmdlet trova un utente tramite posta elettronica. Questo parametro è facoltativo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-FirstName

Specifica il nome dell'utente. Se si specifica questo parametro, questo cmdlet trova un utente in base al nome. Questo parametro è facoltativo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-GroupId

Specifica l'identificatore del gruppo. Se specificato, questo cmdlet trova tutti gli utenti all'interno del gruppo specificato. Questo parametro è facoltativo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LastName

Specifica il cognome di un utente. Se specificato, questo cmdlet trova gli utenti in base al cognome. Questo parametro è facoltativo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-State

Specifica lo stato utente. Se specificato, questo cmdlet trova gli utenti in questo stato. Questo parametro è facoltativo.

Tipo:Nullable<T>[PsApiManagementUserState]
Valori accettati:Active, Blocked, Deleted, Pending
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UserId

Specifica un ID utente. Se specificato, questo cmdlet trova l'utente in base a questo identificatore. Questo parametro è facoltativo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

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

Output