Compartilhar via


New-AzADAppCredential

Cria credenciais de chave ou credenciais de senha para um aplicativo.

Sintaxe

ApplicationObjectIdWithPasswordParameterSet (Default)

New-AzADAppCredential
    -ObjectId <String>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectIdWithCertValueParameterSet

New-AzADAppCredential
    -ObjectId <String>
    -CertValue <String>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectIdWithKeyCredentialParameterSet

New-AzADAppCredential
    -ObjectId <String>
    -KeyCredentials <MicrosoftGraphKeyCredential[]>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectIdWithPasswordCredentialParameterSet

New-AzADAppCredential
    -ObjectId <String>
    -PasswordCredentials <MicrosoftGraphPasswordCredential[]>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectWithPasswordParameterSet

New-AzADAppCredential
    -ApplicationObject <IMicrosoftGraphApplication>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectWithCertValueParameterSet

New-AzADAppCredential
    -CertValue <String>
    -ApplicationObject <IMicrosoftGraphApplication>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayNameWithPasswordParameterSet

New-AzADAppCredential
    -DisplayName <String>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayNameWithCertValueParameterSet

New-AzADAppCredential
    -CertValue <String>
    -DisplayName <String>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationIdWithCertValueParameterSet

New-AzADAppCredential
    -CertValue <String>
    -ApplicationId <Guid>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationIdWithPasswordParameterSet

New-AzADAppCredential
    -ApplicationId <Guid>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectWithPasswordCredentialParameterSet

New-AzADAppCredential
    -PasswordCredentials <MicrosoftGraphPasswordCredential[]>
    -ApplicationObject <IMicrosoftGraphApplication>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayNameWithPasswordCredentialParameterSet

New-AzADAppCredential
    -PasswordCredentials <MicrosoftGraphPasswordCredential[]>
    -DisplayName <String>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationIdWithPasswordCredentialParameterSet

New-AzADAppCredential
    -PasswordCredentials <MicrosoftGraphPasswordCredential[]>
    -ApplicationId <Guid>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationObjectWithKeyCredentialParameterSet

New-AzADAppCredential
    -KeyCredentials <MicrosoftGraphKeyCredential[]>
    -ApplicationObject <IMicrosoftGraphApplication>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayNameWithKeyCredentialParameterSet

New-AzADAppCredential
    -KeyCredentials <MicrosoftGraphKeyCredential[]>
    -DisplayName <String>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationIdWithKeyCredentialParameterSet

New-AzADAppCredential
    -KeyCredentials <MicrosoftGraphKeyCredential[]>
    -ApplicationId <Guid>
    [-CustomKeyIdentifier <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cria credenciais de chave ou credenciais de senha para um aplicativo.

Exemplos

Exemplo 1: Criar credenciais de chave para o aplicativo

# ObjectId is the string representation of a GUID for directory object, application, in Azure AD.
$Id = "00000000-0000-0000-0000-000000000000"
# $cert is Base64 encoded content of certificate
$credential = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.MicrosoftGraphKeyCredential" `
                                 -Property @{'Key' = $cert;
                                 'Usage'       = 'Verify';
                                 'Type'        = 'AsymmetricX509Cert'
                                 }
New-AzADAppCredential -ObjectId $Id -KeyCredentials $credential

Criar credenciais de chave para o aplicativo com a ID do objeto $Id

Exemplo 2: criar credenciais de senha para o aplicativo

# ApplicationId is AppId of Application object which is different from directory id in Azure AD.
Get-AzADApplication -ApplicationId $appId | New-AzADAppCredential -StartDate $startDate -EndDate $endDate

Criar credenciais de senha para o aplicativo

Parâmetros

-ApplicationId

A ID do aplicativo.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationIdWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ApplicationObject

O objeto de aplicativo pode ser usado como entrada de pipeline.

Propriedades do parâmetro

Tipo:IMicrosoftGraphApplication
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationObjectWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertValue

O valor do tipo de credencial 'assimétrica'. Ele representa o certificado codificado em base 64.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CustomKeyIdentifier

Identificador de chave personalizado. O formato deve ser base64: $Bytes=[System.Text.Encoding]::Unicode.GetBytes($key);$key=[Convert]::ToBase64String($Bytes)

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:PSObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisplayName

O nome de exibição do aplicativo.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

DisplayNameWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EndDate

A data de término efetiva do uso da credencial. O valor da data de término padrão é de um ano a partir de hoje. Para uma credencial de tipo 'assimétrica', ela deve ser definida como ativada ou antes da data em que o certificado X509 é válido.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-KeyCredentials

credenciais de chave associadas ao aplicativo.

Propriedades do parâmetro

Tipo:

MicrosoftGraphKeyCredential[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationObjectIdWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ObjectId

A ID do objeto do aplicativo.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ID

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectIdWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectIdWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PasswordCredentials

Credenciais de senha associadas ao aplicativo.

Propriedades do parâmetro

Tipo:

MicrosoftGraphPasswordCredential[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StartDate

A data de início efetiva do uso da credencial. O valor da data de início padrão é hoje. Para uma credencial de tipo 'assimétrica', ela deve ser definida como ativada ou após a data da qual o certificado X509 é válido.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DisplayNameWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ApplicationIdWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

IMicrosoftGraphApplication

Saídas

IMicrosoftGraphKeyCredential

IMicrosoftGraphPasswordCredential