Partilhar via

New-AzureADServicePrincipal

  • Referência
Módulo:
AzureAD

Cria um principal de serviço.

Sintaxe

New-AzureADServicePrincipal
   [-AccountEnabled <String>]
   [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
   -AppId <String>
   [-AppRoleAssignmentRequired <Boolean>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-Homepage <String>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-LogoutUrl <String>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PublisherName <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-SamlMetadataUrl <String>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalType <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

Exemplos

Exemplo 1: Criar um principal de serviço

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

Este comando cria um principal de serviço. A etiqueta "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" é utilizada para que este principal de serviço seja apresentado na lista de Aplicações Integradas no Portal de Administração.

Parâmetros

-AccountEnabled

true se a conta do principal de serviço estiver ativada; caso contrário, falso.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AlternativeNames

Os nomes alternativos para este principal de serviço

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppId

O identificador exclusivo da aplicação associada (a respetiva propriedade appId).

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppRoleAssignmentRequired

Indica se é necessária uma atribuição de função de aplicação.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica o nome a apresentar.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ErrorUrl

Especifica o URL de erro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Homepage

Especifica a home page.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyCredentials

A coleção de credenciais de chave associadas ao principal de serviço.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogoutUrl

Especifica o URL de fim de sessão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PasswordCredentials

Especifica credenciais de palavra-passe.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublisherName

Especifica o nome do publicador.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ReplyUrls

Os URLs para os quais os tokens de utilizador são enviados para iniciar sessão com a aplicação associada ou os URIs de redirecionamento para os quais os códigos de autorização E tokens de acesso do OAuth 2.0 são enviados para a aplicação associada.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SamlMetadataUrl

O URL dos metadados SAML

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServicePrincipalNames

Especifica uma matriz de nomes de principais de serviço. Com base na coleção identifierURIs, além da propriedade appId da aplicação, estes URIs são utilizados para referenciar o principal de serviço de uma aplicação. Um cliente irá utilizá-los para:

  • preencha requiredResourceAccess, através de "Permissões para outras aplicações" no portal clássico do Azure. - especifique um URI de recurso para adquirir um token de acesso, que é o URI devolvido na afirmação.
Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServicePrincipalType

Tipo THe do principal de serviço

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tags

Etiquetas ligadas a este principal de serviço.

Tenha em atenção que, se pretender que este principal de serviço seja apresentado na lista Todas as Aplicações no portal de administração, tem de definir este valor como {WindowsAzureActiveDirectoryIntegratedApp}

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Notas

Veja o guia de migração de New-AzureADServicePrincipal para o Microsoft Graph PowerShell.