New-AzureADServicePrincipal

  • Referência
Módulo:
AzureAD

Cria uma entidade 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 uma entidade de serviço

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

Esse comando cria uma entidade de serviço. A marca "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" é usada para que essa entidade de serviço apareça na lista de Aplicativos Integrados no Portal do Administração.

Parâmetros

-AccountEnabled

true se a conta da entidade de serviço estiver habilitada, caso contrário, false.

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

-AlternativeNames

Os nomes alternativos para essa entidade 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 para o aplicativo associado (sua propriedade appId).

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

-AppRoleAssignmentRequired

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

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

-DisplayName

Especifica o nome para exibição.

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

-ErrorUrl

Especifica a URL do 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 de chave associada à entidade 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 a URL de logoff.

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

-PasswordCredentials

Especifica credenciais de senha.

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 editor.

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

-ReplyUrls

As URLs para as quais os tokens de usuário são enviados para entrar com o aplicativo associado ou o redirecionamento de URIs para os quais os códigos de autorização de OAuth 2.0 e tokens de acesso são enviados pelo aplicativo associado.

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

-SamlMetadataUrl

A URL para os metadados do 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 entidade de serviço. Com base na coleção identifierURIs, além da propriedade appId do aplicativo, esses URIs são usados para fazer referência à entidade de serviço de um aplicativo. Um cliente os usará para:

  • preencha requiredResourceAccess por meio de "Permissões para outros aplicativos" no portal clássico do Azure. – especifique um URI de recurso para adquirir um token de acesso, que é o URI retornado na declaração.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

Tipo THe da entidade de serviço

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

-Tags

Marcas vinculadas a essa entidade de serviço.

Observe que, se você pretende que essa entidade de serviço apareça na lista Todos os Aplicativos no portal de administração, você precisará definir esse valor como {WindowsAzureActiveDirectoryIntegratedApp}

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

Observações

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