Partilhar via


Get-AzApiManagementGroup

Obtém todos ou grupos de gerenciamento de API específicos.

Syntax

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

O cmdlet Get-AzApiManagementGroup obtém todos ou grupos de gerenciamento de API específicos.

Exemplos

Exemplo 1: Obter todos os grupos

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

Este comando obtém todos os grupos.

Exemplo 2: Obter um grupo por ID

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

Este comando obtém o ID do grupo chamado 0123456789.

Exemplo 3: Obter um grupo por nome

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

Este comando obtém o grupo chamado Group0002.

Exemplo 4: Obter todos os grupos de usuários

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

Este comando obtém todos os grupos de usuários com o ID de usuário chamado 0123456789.

Parâmetros

-Context

Especifica uma instância de PsApiManagementContext.

Tipo:PsApiManagementContext
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupId

Especifica a ID do grupo. Se especificado, o cmdlet tenta localizar o grupo pelo identificador.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome do grupo de gerenciamento.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-ProductId

Identificador do produto existente. Se especificado retornará todos os grupos aos quais o produto foi atribuído. Este parâmetro é opcional.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-UserId

Especifica o identificador do produto existente. Se especificado, o cmdlet retornará todos os grupos aos quais o produto foi atribuído.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PsApiManagementContext

String

Saídas

PsApiManagementGroup