Partilhar via


New-AzADAppCredential

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

Sintaxe

ApplicationObjectIdWithPasswordParameterSet (Predefinição)

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

O ID do aplicativo.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationIdWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithPasswordParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApplicationObject

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

Propriedades dos parâmetros

Tipo:IMicrosoftGraphApplication
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationObjectWithPasswordParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CertValue

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationObjectIdWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CustomKeyIdentifier

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:PSObject
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DisplayName

O nome para exibição do aplicativo.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

DisplayNameWithPasswordParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EndDate

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

Propriedades dos parâmetros

Tipo:DateTime
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectIdWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-KeyCredentials

credenciais de chave associadas ao aplicativo.

Propriedades dos parâmetros

Tipo:

MicrosoftGraphKeyCredential[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationObjectIdWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ObjectId

O objeto Id do aplicativo.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Id

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectIdWithCertValueParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectIdWithKeyCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectIdWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PasswordCredentials

Credenciais de senha associadas ao aplicativo.

Propriedades dos parâmetros

Tipo:

MicrosoftGraphPasswordCredential[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithPasswordCredentialParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StartDate

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

Propriedades dos parâmetros

Tipo:DateTime
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ApplicationObjectIdWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectIdWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationObjectWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
DisplayNameWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithCertValueParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ApplicationIdWithPasswordParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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