共用方式為

New-AzApiManagementUser

  • 參考
模組:
Az.ApiManagement

註冊新的使用者。

語法

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

Description

New-AzApiManagementUser Cmdlet 會註冊新的使用者。

範例

範例 1：註冊新的使用者

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

此命令會註冊名為 Patti Fuller 的新使用者。

參數

-Context

指定 PsApiManagementContext 物件。

類型:PsApiManagementContext
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Email

指定使用者的電子郵件位址。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-FirstName

指定使用者的名字。 此參數長度必須為1到100個字元。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-LastName

指定使用者的姓氏。 此參數長度必須為1到100個字元。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Note

指定使用者的相關附註。 這個參數是選擇性的。 預設值為 $Null。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Password

指定用戶密碼。 這是必要參數。

類型:SecureString
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-State

指定用戶狀態。 這個參數是選擇性的。 此參數的預設值為 $Null。

類型:Nullable<T>[PsApiManagementUserState]
接受的值:Active, Blocked, Deleted, Pending
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-UserId

指定使用者識別碼。 這個參數是選擇性的。 如果未指定此參數，這個 Cmdlet 會產生使用者識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

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

輸出

PsApiManagementUser