# Convidar Utilizadores Convidados Externos

### Descrição

Este runbook convida um usuário externo como usuário convidado no Microsoft Entra ID. Propriedades opcionais do perfil, como nome, sobrenome, nome da empresa, local de uso e gerente, podem ser definidas após a aceitação do convite. O usuário convidado pode opcionalmente ser adicionado a um grupo especificado.

### Localização

Organização → Geral → Convidar usuários convidados externos

**Nome completo do Runbook**

rjgit-org\_general\_Invite-external-guest-users

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * User.ReadWrite.All
  * Group.ReadWrite.All

### Parâmetros

#### InvitedUserEmail

Endereço de e-mail do usuário convidado a ser convidado.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | true   |
| Valor padrão |        |
| Tipo         | String |

#### InvitedUserDisplayName

Nome de exibição do usuário convidado.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### GroupId

O ID do objeto do grupo ao qual adicionar o usuário convidado. Se não for especificado, o usuário não será adicionado a nenhum grupo.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### GivenName

Nome próprio (primeiro nome) do usuário convidado.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### Surname

Sobrenome (último nome) do usuário convidado.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### CompanyName

Nome da empresa do usuário convidado.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### ManagerName

Gerente a ser atribuído ao usuário convidado. Selecione um usuário do diretório.

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

#### UsageLocation

Código de país ISO 3166-1 alpha-2 para o local de uso do usuário convidado (por exemplo, "US", "DE").

| Propriedade  | Valor  |
| ------------ | ------ |
| Obrigatório  | false  |
| Valor padrão |        |
| Tipo         | String |

[Voltar para a visão geral da Referência de Runbook](/pt/automacao/runbooks/runbook-references.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.