Add-RecipientPermission

Module:

ExchangePowerShell

S’applique à:

Exchange Online

Cette cmdlet est disponible uniquement dans le service cloud.

La cmdlet Add-RecipientPermission permet d’ajouter une autorisation Envoyer en tant que aux utilisateurs d’une organisation en nuage.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Add-RecipientPermission
   [-Identity] <RecipientIdParameter>
   -AccessRights <MultiValuedProperty>
   -Trustee <SecurityPrincipalIdParameter>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

L’autorisation SendAs permet à un utilisateur ou aux membres du groupe d’envoyer des messages qui semblent provenir de la boîte aux lettres, du contact de messagerie, de l’utilisateur de messagerie ou du groupe spécifié.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Add-RecipientPermission "Help Desk" -AccessRights SendAs -Trustee "Ayla Kol"

Cet exemple accorde à l’utilisateur Ayla Kol l’autorisation Envoyer en tant que pour la boîte aux lettres Help Desk. Ayla peut envoyer des messages semblant provenir directement de la boîte aux lettres « Help Desk ».

Paramètres

-AccessRights

Le paramètre AccessRights spécifie l’autorisation que vous souhaitez ajouter pour le fiduciaire sur le destinataire cible. La seule valeur valide pour ce paramètre est SendAs.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

• Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Le paramètre Identity spécifie le destinataire cible. L’utilisateur ou le groupe spécifié par le paramètre Trustee reçoit l’autorisation SendAs sur ce destinataire.

Vous pouvez par exemple spécifier n’importe quel type de destinataire :

• Boîtes aux lettres
• Utilisateurs de messagerie
• Contacts externes
• Groupes de distribution
• groupes de distribution dynamiques

Vous pouvez utiliser une valeur quelconque qui identifie le destinataire. Par exemple :

• Nom
• Alias
• Nom unique
• Nom unique
• Nom unique canonique
• GUID

Type:	RecipientIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Trustee

Le paramètre Trustee spécifie l’utilisateur ou le groupe qui reçoit l’autorisation SendAs sur le destinataire spécifié par le paramètre Identity. Vous pouvez spécifier les types d’utilisateurs ou de groupes suivants (principaux de sécurité) pour ce paramètre :

• Utilisateurs de boîte aux lettres
• Envoyer des messages aux utilisateurs avec un compte Microsoft
• Groupes de sécurité

Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur ou le groupe de manière unique. Par exemple :

• Nom
• Alias
• Nom unique
• Nom unique
• Domaine\Nom d’utilisateur
• Adresse e-mail
• GUID
• LegacyExchangeDN
• SamAccountName
• Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Type:	SecurityPrincipalIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.