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 do Administração.

Parâmetros

-AccountEnabled

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternativeNames

Os nomes alternativos deste principal de serviço

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppRoleAssignmentRequired

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica o nome a apresentar.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorUrl

Especifica o URL de erro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Homepage

Especifica a home page.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyCredentials

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

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

Especifica o URL de fim de sessão.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordCredentials

Especifica credenciais de palavra-passe.

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

Especifica o nome do publicador.

Type:String
Position:Named
Default value:None
Required: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 os tokens de acesso do OAuth 2.0 são enviados para a aplicação associada.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

O URL dos metadados SAML

Type:String
Position:Named
Default value:None
Required: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.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

Tipo de THe do principal de serviço

Type:String
Position:Named
Default value:None
Required: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, terá de definir este valor como {WindowsAzureActiveDirectoryIntegratedApp}

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notas

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