Freigeben über


New-AzApiManagementUser

Registriert einen neuen Benutzer.

Syntax

New-AzApiManagementUser
   -Context <PsApiManagementContext>
   [-UserId <String>]
   -FirstName <String>
   -LastName <String>
   -Email <String>
   -Password <SecureString>
   [-State <PsApiManagementUserState>]
   [-Note <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzApiManagementUser registriert einen neuen Benutzer.

Beispiele

Beispiel 1: Registrieren eines neuen Benutzers

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
$securePassword = ConvertTo-SecureString "qwerty" -AsPlainText -Force
New-AzApiManagementUser -Context $apimContext -FirstName "Patti" -LastName "Fuller" -Email "Patti.Fuller@contoso.com" -Password $securePassword

Mit diesem Befehl wird ein neuer Benutzer namens Patti Fuller registriert.

Parameter

-Context

Gibt ein PsApiManagementContext -Objekt an.

Typ:PsApiManagementContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Email

Gibt die E-Mail-Adresse des Benutzers an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-FirstName

Gibt den Vornamen des Benutzers an. Dieser Parameter muss 1 bis 100 Zeichen lang sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LastName

Gibt den Nachnamen des Benutzers an. Dieser Parameter muss 1 bis 100 Zeichen lang sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Note

Gibt eine Notiz zum Benutzer an. Dieser Parameter ist optional. Der Standardwert ist $Null.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Password

Gibt das Benutzerkennwort an. Dieser Parameter ist erforderlich.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-State

Gibt den Benutzerstatus an. Dieser Parameter ist optional. Der Standardwert dieses Parameters ist $Null.

Typ:Nullable<T>[PsApiManagementUserState]
Zulässige Werte:Active, Blocked, Deleted, Pending
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UserId

Gibt die Benutzer-ID an. Dieser Parameter ist optional. Wenn dieser Parameter nicht angegeben ist, generiert dieses Cmdlet eine Benutzer-ID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PsApiManagementContext

String

SecureString

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

Ausgaben

PsApiManagementUser