Edit

Share via


New-EntraBetaInvitation

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

Syntax

Default (Default)

New-EntraBetaInvitation

    [-InvitedUser <User>]
    [-InvitedUserMessageInfo <InvitedUserMessageInfo>]
    [-InvitedUserType <String>]
    [-SendInvitationMessage <Boolean>]
    -InvitedUserEmailAddress <String>
    [-ResetRedemption]
    [-InvitedUserDisplayName <String>]
    -InviteRedirectUrl <String>
    [<CommonParameters>]

Description

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

Invitation adds an external user to the organization. When creating a new invitation, you have several options available:

  • On invitation creation, Microsoft Graph can automatically send an invitation email directly to the invited user, or your app can use the inviteRedeemUrl returned in the response to craft your own invitation (through your communication mechanism of choice) to the invited user. If you decide to have Microsoft Graph send an invitation email automatically, you can specify the content and language of the email by using invitedUserMessageInfo.

  • When the user is invited, a user entity (of userType Guest) is created and can be used to control access to resources. The invited user has to go through the redemption process to access any resources they have been invited to.

To reset the redemption status for a guest user, the User.ReadWrite.All permission is the minimum required.

For delegated scenarios, the signed-in user must have at least one of the following roles:

  • Guest Inviter
  • Directory Writers
  • User Administrator

Additionally, to reset the redemption status, the signed-in user must have the:

  • Helpdesk Administrator
  • User Administrator role

Parameters

-InvitedUser

An existing user object in the directory that you want to add or update the B2B credentials for.

Parameter properties

Type:User
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InvitedUserDisplayName

The display name of the user as it appears in your directory.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InvitedUserEmailAddress

The Email address to which the invitation is sent.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InvitedUserMessageInfo

Addition information to specify how the invitation message is sent.

Parameter properties

Type:InvitedUserMessageInfo
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InvitedUserType

The userType of the user being invited. By default, this is Guest.

You can invite as Member if you are company administrator.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InviteRedirectUrl

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

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResetRedemption

Indicates whether the invite redemption on an existing external user should be removed so the user can re-redeem the account.

By default, this is false and should only be set when passing in a valid external user to the InvitedUser property.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SendInvitationMessage

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

Parameter properties

Type:System.Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object

Notes