Partager via

Add-RecipientPermission

Module:
Exchange PowerShell

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.

Syntaxe

Default (Par défaut) 

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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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

Applicable : Exchange Online

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.

Propriétés du paramètre

Type:MultiValuedProperty
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Confirm

Applicable : Exchange Online

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-*) comportent 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.

Cette applet de commande a une pause intégrée. Utilisez -Confirm:$false donc pour ignorer la confirmation.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : Exchange Online

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

Propriétés du paramètre

Type:RecipientIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Trustee

Applicable : Exchange Online

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)

Propriétés du paramètre

Type:SecurityPrincipalIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Applicable : Exchange Online

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.