Partilhar via

New-AzureADServicePrincipal

  • Referência
Módulo:
AzureAD

Cria um principal de serviço.

Syntax

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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternativeNames

Os nomes alternativos para este principal de serviço

Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

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

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

-AppRoleAssignmentRequired

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

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

-DisplayName

Especifica o nome a apresentar.

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

-ErrorUrl

Especifica o URL de erro.

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

-Homepage

Especifica a home page.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

Especifica o URL de fim de sessão.

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

-PasswordCredentials

Especifica credenciais de palavra-passe.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

Especifica o nome do publicador.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

O URL dos metadados SAML

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

Tipo THe do principal de serviço

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

Notas

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