Compartilhar via


New-AzADSpCredential

Cria credenciais de chave ou credenciais de senha para uma entidade de serviço.

Sintaxe

SpObjectIdWithPasswordParameterSet (Default)

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

SpObjectIdWithCertValueParameterSet

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

SpObjectIdWithKeyCredentialParameterSet

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

SpObjectIdWithPasswordCredentialParameterSet

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

ServicePrincipalObjectWithCertValueParameterSet

New-AzADSpCredential
    -CertValue <String>
    -ServicePrincipalObject <IMicrosoftGraphServicePrincipal>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServicePrincipalObjectWithPasswordParameterSet

New-AzADSpCredential
    -ServicePrincipalObject <IMicrosoftGraphServicePrincipal>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SPNWithCertValueParameterSet

New-AzADSpCredential
    -CertValue <String>
    -ServicePrincipalName <String>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SPNWithPasswordParameterSet

New-AzADSpCredential
    -ServicePrincipalName <String>
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServicePrincipalObjectWithPasswordCredentialParameterSet

New-AzADSpCredential
    -PasswordCredentials <MicrosoftGraphPasswordCredential[]>
    -ServicePrincipalObject <IMicrosoftGraphServicePrincipal>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SPNWithPasswordCredentialParameterSet

New-AzADSpCredential
    -PasswordCredentials <MicrosoftGraphPasswordCredential[]>
    -ServicePrincipalName <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServicePrincipalObjectWithKeyCredentialParameterSet

New-AzADSpCredential
    -KeyCredentials <MicrosoftGraphKeyCredential[]>
    -ServicePrincipalObject <IMicrosoftGraphServicePrincipal>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SPNWithKeyCredentialParameterSet

New-AzADSpCredential
    -KeyCredentials <MicrosoftGraphKeyCredential[]>
    -ServicePrincipalName <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cria credenciais de chave ou credenciais de senha para uma entidade de serviço.

Exemplos

Exemplo 1: Criar credenciais de chave para a entidade de serviço

$credential = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.MicrosoftGraphKeyCredential" `
                                 -Property @{'Key' = $cert;
                                 'Usage'       = 'Verify';
                                 'Type'        = 'AsymmetricX509Cert'
                                 }
New-AzADSpCredential -ObjectId $Id -KeyCredentials $credential

Criar credenciais de chave para a entidade de serviço

Exemplo 2: Criar credenciais de senha para a entidade de serviço

Get-AzADServicePrincipal -ApplicationId $appId | New-AzADSpCredential -StartDate $startDate -EndDate $endDate

Criar credenciais de senha para a entidade de serviço

Parâmetros

-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

SpObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithCertValueParameterSet
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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com 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

-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

SpObjectIdWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SpObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithPasswordParameterSet
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 à entidade de serviço.

Propriedades do parâmetro

Tipo:

MicrosoftGraphKeyCredential[]

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

Conjuntos de parâmetros

SpObjectIdWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithKeyCredentialParameterSet
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, ServicePrincipalObjectId

Conjuntos de parâmetros

SpObjectIdWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SpObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SpObjectIdWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SpObjectIdWithPasswordCredentialParameterSet
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 à entidade de serviço.

Propriedades do parâmetro

Tipo:

MicrosoftGraphPasswordCredential[]

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

Conjuntos de parâmetros

SpObjectIdWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServicePrincipalName

O nome da entidade de serviço.

Propriedades do parâmetro

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

Conjuntos de parâmetros

SPNWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServicePrincipalObject

O objeto da entidade de serviço pode ser usado como entrada de pipeline.

Propriedades do parâmetro

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

Conjuntos de parâmetros

ServicePrincipalObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithPasswordParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithPasswordCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithKeyCredentialParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:True
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

SpObjectIdWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SpObjectIdWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ServicePrincipalObjectWithPasswordParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithCertValueParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SPNWithPasswordParameterSet
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

IMicrosoftGraphServicePrincipal

Saídas

IMicrosoftGraphKeyCredential

IMicrosoftGraphPasswordCredential

Observações

ALIASES

New-AzADServicePrincipalCredential