Partilhar via


New-AzApiManagementUser

Registra um novo usuário.

Syntax

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

Description

O cmdlet New-AzApiManagementUser registra um novo usuário.

Exemplos

Exemplo 1: Registar um novo utilizador

$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

Este comando registra um novo usuário chamado Patti Fuller.

Parâmetros

-Context

Especifica um objeto 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

-Email

Especifica o endereço de e-mail do usuário.

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

-FirstName

Especifica o nome do usuário. Este parâmetro deve ter de 1 a 100 caracteres.

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

-LastName

Especifica o sobrenome do usuário. Este parâmetro deve ter de 1 a 100 caracteres.

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

-Note

Especifica uma nota sobre o usuário. Este parâmetro é opcional. O valor padrão é $Null.

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

-Password

Especifica a senha do usuário. Este parâmetro é obrigatório.

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

-State

Especifica o estado do usuário. Este parâmetro é opcional. O valor padrão desse parâmetro é $Null.

Tipo:Nullable<T>[PsApiManagementUserState]
valores aceites:Active, Blocked, Deleted, Pending
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-UserId

Especifica o ID do usuário. Este parâmetro é opcional. Se esse parâmetro não for especificado, esse cmdlet gerará uma ID de usuário.

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

Entradas

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

Saídas

PsApiManagementUser