New-AzureADServicePrincipal
Cria uma entidade 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 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 de Administração.
Parâmetros
-AccountEnabled
true se a conta da entidade de serviço estiver habilitada, caso contrário, false.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AlternativeNames
Os nomes alternativos para essa entidade de serviço
| Tipo: | List<T>[String] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AppId
O identificador exclusivo para o aplicativo associado (sua propriedade appId).
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AppRoleAssignmentRequired
Indica se uma atribuição de função de aplicativo é necessária.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisplayName
Especifica o nome para exibição.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ErrorUrl
Especifica a URL do erro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Homepage
Especifica a home page.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-KeyCredentials
A coleção de credenciais de chave associada à entidade de serviço.
| Tipo: | List<T>[Microsoft.Open.AzureAD.Model.KeyCredential] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LogoutUrl
Especifica a URL de logoff.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PasswordCredentials
Especifica as credenciais de senha.
| Tipo: | List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PublisherName
Especifica o nome do editor.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | List<T>[String] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SamlMetadataUrl
A URL para os metadados do SAML
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 referenciar a 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.
| Tipo: | List<T>[String] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ServicePrincipalType
Tipo THe da entidade de serviço
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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}
| Tipo: | List<T>[String] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Observações
Consulte o guia de migração para New-AzureADServicePrincipal para o Microsoft Graph PowerShell.