New-​Azure​AD​MS​Invitation

This cmdlet is used to invite a new external user to your directory

Syntax

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

Description

This cmdlet is used to invite a new external user to your directory.

Examples

Invite a new external user to your directory

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

Using the cmdlet in this example, an email is sent to the user who's email address is in the -InvitedUserEmailAddress parameter. When the user accepts the invitation, they are forwarded to the url as specified in the -InviteRedirectUrl parameter

Required Parameters

-InviteRedirectUrl

The URL to which the invited user is forwarded after accepting the invitation

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

The Email address to which the invitation is sent

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

Optional Parameters

-InvitedUserDisplayName

The display name of the user as it will appear in your directory

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

Addition information to specify how the invitation message is sent

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

The userType of the user being invited. By default, this is Guest. You can invite as Member if you're are company administrator.

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

A Boolean parameter that indicates whether or not an invitation message will be sent to the invited user.

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

Inputs

None

Outputs

System.Object