Freigeben über

New-AzApiManagementGroup

  • Referenz
Modul:
Az.ApiManagement

Erstellt eine API-Verwaltungsgruppe.

Syntax

New-AzApiManagementGroup
   -Context <PsApiManagementContext>
   [-GroupId <String>]
   -Name <String>
   [-Description <String>]
   [-Type <PsApiManagementGroupType>]
   [-ExternalId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzApiManagementGroup erstellt eine API-Verwaltungsgruppe.

Beispiele

Beispiel 1: Erstellen einer Verwaltungsgruppe

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

Mit diesem Befehl wird eine Verwaltungsgruppe erstellt.

Beispiel 2

Erstellt eine API-Verwaltungsgruppe. (automatisch generiert)

New-AzApiManagementGroup -Context <PsApiManagementContext> -Description 'Create Echo Api V4' -GroupId '0001' -Name 'Group0001' -Type Custom

Parameter

-Context

Gibt die Instanz des PsApiManagementContext -Objekts an.

Type:PsApiManagementContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt die Beschreibung der Verwaltungsgruppe an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExternalId

Bei externen Gruppen enthält diese Eigenschaft die ID der Gruppe vom externen Identitätsanbieter, z. B. Azure Active Directory-aad://contoso5api.onmicrosoft.com/groups/12ad42b1-592f-4664-a77b4250-2f2e82579f4c; andernfalls ist der Wert NULL.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupId

Gibt den Bezeichner der neuen Verwaltungsgruppe an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Verwaltungsgruppennamen an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Type

Gruppentyp. Benutzerdefinierte Gruppe ist benutzerdefinierte Gruppe. Die Systemgruppe umfasst Administrator, Entwickler und Gäste. Sie können keine Systemgruppe erstellen oder aktualisieren. Externe Gruppe ist Gruppen von externem Identitätsanbieter wie Azure Active Directory. Dieser Parameter ist optional und wird standardmäßig als benutzerdefinierte Gruppe angenommen.

Type:Nullable<T>[PsApiManagementGroupType]
Accepted values:Custom, System, External
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

PsApiManagementContext

String

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

Ausgaben

PsApiManagementGroup