New-ServicePrincipal
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet New-ServicePrincipal para criar principais de serviço na sua organização baseada na cloud.
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
Os principais de serviço existem no Microsoft Entra ID para definir o que as aplicações podem fazer, quem pode aceder às aplicações e a que recursos as aplicações podem aceder. No Exchange Online, os principais de serviço são referências aos principais de serviço no Microsoft Entra ID. Para atribuir Exchange Online funções de controlo de acesso baseado em funções (RBAC) a principais de serviço no Microsoft Entra ID, utilize as referências do principal de serviço no Exchange Online. Os cmdlets *-ServicePrincipal no Exchange Online PowerShell permitem-lhe ver, criar e remover estas referências do principal de serviço.
Para obter mais informações, veja Objetos de principal de serviço e aplicação no Microsoft Entra ID.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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
Este exemplo cria um novo principal de serviço no Exchange Online com os valores AppId e ObjectId especificados.
Parâmetros
-AppId
Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro AppId especifica o valor GUID de AppId exclusivo para o principal de serviço. Por exemplo, ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Está disponível um valor válido para este parâmetro nas seguintes localizações:
- A propriedade AppId na saída do cmdlet Get-MgServicePrincipal no Microsoft Graph PowerShell.
- A propriedade ID da Aplicação das aplicações 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não 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 confirmar 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro DisplayName especifica o nome amigável do principal 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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ObjectId especifica o valor GUID de ObjectId exclusivo para o principal de serviço. Por exemplo, 7c7599b2-23af-45e3-99ff-0025d148e929.
Está disponível um valor válido para este parâmetro nas seguintes localizações:
- A propriedade ID na saída do cmdlet Get-MgServicePrincipal no Microsoft Graph PowerShell.
- A propriedade ID do Objeto das aplicações 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: Conformidade do & de Segurança
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, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
Este parâmetro está a ser preterido. Em alternativa, utilize 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
Aplicável: Exchange Online, Conformidade & de Segurança, Suplemento de segurança incorporado para caixas de correio no local
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.