New-AzureADMSInvitation

Referência

Módulo:: AzureAD

Esse cmdlet é usado para convidar um novo usuário externo para seu diretório.

Syntax

New-AzureADMSInvitation
   [-InvitedUserDisplayName <String>]
   -InvitedUserEmailAddress <String>
   [-SendInvitationMessage <Boolean>]
   -InviteRedirectUrl <String>
   [-InvitedUserMessageInfo <InvitedUserMessageInfo>]
   [-InvitedUserType <String>]
   [<CommonParameters>]

Description

Esse cmdlet é usado para convidar um novo usuário externo para seu diretório.

Exemplos

Convidar um novo usuário externo para seu diretório

New-AzureADMSInvitation -InvitedUserEmailAddress someexternaluser@externaldomain.com -SendInvitationMessage $True -InviteRedirectUrl "http://myapps.microsoft.com"

Id                      : 6058156a-93d1-4958-a738-ddc4ab4432cf
InvitedUserDisplayName  :
InvitedUserEmailAddress : someexternaluser@externaldomain.com
SendInvitationMessage   : True
InviteRedeemUrl         : https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3d06f6521d-c18c-460a-8656-fa82e81aa94b%26user%3d7b67d069-163b-4f7e-9118-c9ceeda363d9%26ticket%3ddANXuWQMNhYv21%252bFBm%252fULkTqCnpX6vNvRgTHQmsECPU%253d%26ver%3d2.0
InviteRedirectUrl       : http://myapps.microsoft.com/
InvitedUser             : class User {
                            Id: 04fd8318-77ca-428e-b7f2-2bb1ef7a0100
                            OdataType:
                          }

InvitedUserMessageInfo  : class InvitedUserMessageInfo {
                            CcRecipients: System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.Recipient]
                            CustomizedMessageBody:
                            MessageLanguage:
                          }

InvitedUserType         : Guest
Status                  : PendingAcceptance

Usando o cmdlet neste exemplo, um email é enviado ao usuário cujo endereço de email está no parâmetro -InvitedUserEmailAddress. Quando o usuário aceita o convite, ele é encaminhado para a URL conforme especificado no parâmetro -InviteRedirectUrl

Parâmetros

-InvitedUserDisplayName

O nome de exibição do usuário como ele aparecerá em seu diretório.

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

-InvitedUserEmailAddress

O Email endereço ao qual o convite é enviado.

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

-InvitedUserMessageInfo

Informações adicionais para especificar como a mensagem de convite é enviada

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

-InvitedUserType

O userType do usuário que está sendo convidado. Por padrão, isso é Convidado. Você pode convidar como Membro se for administrador da empresa.

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

-InviteRedirectUrl

A URL para a qual o usuário convidado é encaminhado após aceitar o convite.

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

-SendInvitationMessage

Um parâmetro booliano que indica se uma mensagem de convite será enviada ou não ao usuário convidado.

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

Entradas

None

Saídas

Object