New-ServicePrincipal
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet New-ServicePrincipal para criar entidades de serviço em sua organização baseada em nuvem.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
New-ServicePrincipal
-AppId <String>
-ObjectId <String>
-ServiceId <String>
[-Confirm]
[-DisplayName <String>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
Existem entidades de serviço no Microsoft Entra ID para definir o que os aplicativos podem fazer, quem pode acessar os aplicativos e quais recursos os aplicativos podem acessar. No Exchange Online, as entidades de serviço são referências às entidades de serviço no Microsoft Entra ID. Para atribuir funções de RBAC (controle de acesso baseado em função) do Exchange Online a entidades de serviço no Microsoft Entra ID, use as referências da entidade de serviço no Exchange Online. Os cmdlets *-ServicePrincipal no PowerShell do Exchange Online permitem exibir, criar e remover essas referências da entidade de serviço.
Para obter mais informações, consulte Objetos de entidade de serviço e aplicativo no Microsoft Entra ID.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
New-ServicePrincipal -AppId 71487acd-ec93-476d-bd0e-6c8b31831053 -ObjectId 6233fba6-0198-4277-892f-9275bf728bcc
Neste exemplo, crie uma entidade de serviço no Exchange Online com os valores de AppId e ObjectId especificados.
Parâmetros
-AppId
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro AppId especifica o valor GUID AppId exclusivo para a entidade de serviço. Por exemplo, ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Um valor válido para esse parâmetro está disponível nos seguintes locais:
- A propriedade AppId na saída do cmdlet Get-MgServicePrincipal no Microsoft Graph PowerShell.
- A propriedade ID do Aplicativo de aplicativos empresariais no centro de administração do Microsoft Entra: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DisplayName
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro DisplayName especifica o nome amigável da entidade de serviço. Se o nome contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ObjectId
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro ObjectId especifica o valor exclusivo do GUID de ObjectId para a entidade de serviço. Por exemplo, 7c7599b2-23af-45e3-99ff-0025d148e929.
Um valor válido para esse parâmetro está disponível nos seguintes locais:
- A propriedade Id na saída do cmdlet Get-MgServicePrincipal no Microsoft Graph PowerShell.
- A propriedade ID do Objeto de aplicativos empresariais no centro de administração do Microsoft Entra: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Organization
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | OrganizationIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ServiceId
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
Esse parâmetro está sendo preterido. Em vez disso, use o parâmetro ObjectId.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.