Get-EXORecipientPermission

Cette applet de commande est disponible uniquement dans le module PowerShell Exchange Online. Pour plus d’informations, consultez À propos du module PowerShell Exchange Online.

Utilisez l’applet de commande Get-EXORecipientPermission pour afficher des informations sur les autorisations SendAs configurées pour les utilisateurs d’une organisation cloud.

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

Syntax

Get-EXORecipientPermission
   [-AccessRights <MultiValuedProperty>]
   [-ResultSize <Unlimited>]
   [-Trustee <String>]
   [<CommonParameters>]
Get-EXORecipientPermission
   [[-Identity] <String>]
   [-AccessRights <MultiValuedProperty>]
   [-ExternalDirectoryObjectId <Guid>]
   [-PrimarySmtpAddress <String>]
   [-ResultSize <Unlimited>]
   [-Trustee <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Description

Cette applet de commande est utilisée pour afficher/gérer les informations sur les autorisations SendAs configurées pour les utilisateurs d’une organisation cloud. L’autorisation Envoyer en tant que permet aux délégués d’utiliser la boîte aux lettres pour envoyer des messages. Une fois cette autorisation attribuée à un délégué, tout message envoyé par le délégué à partir de la boîte aux lettres semble avoir été envoyé par le propriétaire de la boîte aux lettres. Toutefois, cette autorisation ne permet pas à un délégué de se connecter à la boîte aux lettres de l'utilisateur. Il permet uniquement aux utilisateurs d’ouvrir la boîte aux lettres. Si cette autorisation est attribuée à un groupe, un message envoyé par le délégué semble avoir été envoyé par le groupe.

Exemples

Exemple 1

Get-EXORecipientPermission -ResultSize 100

L’exemple ci-dessus retourne l’autorisation de destinataire pour les 100 premiers utilisateurs de boîte aux lettres dans l’ordre de tri des noms.

Paramètres

-AccessRights

Le paramètre AccessRights filtre les résultats par autorisation. La seule valeur valide pour ce paramètre est SendAs.

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

-ExternalDirectoryObjectId

Le paramètre ExternalDirectoryObjectId identifie le destinataire que vous souhaitez afficher par ObjectId dans Azure Active Directory.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres Identity, PrimarySmtpAddress ou UserPrincipalName.

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

-Identity

Le paramètre Identity identifie le destinataire que vous souhaitez afficher. L’utilisateur ou le groupe spécifié par le paramètre Trustee dispose des autorisations Envoyer en tant que sur ce destinataire. Vous pouvez par exemple spécifier n’importe quel type de destinataire :

  • Boîtes aux lettres
  • Utilisateurs de messagerie
  • Contacts de messagerie
  • Groupes de distribution
  • Groupes de distribution dynamique

Pour des performances optimales, nous vous recommandons d’utiliser les valeurs suivantes pour identifier le destinataire :

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)
  • GUID

Sinon, vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Domaine\Nom d’utilisateur
  • Adresse électronique
  • LegacyExchangeDN
  • SamAccountName

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.

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

-PrimarySmtpAddress

PrimarySmtpAddress identifie le destinataire que vous souhaitez afficher par adresse e-mail SMTP principale (par exemple, navin@contoso.com).

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExternalDirectoryObjectId, Identity ou UserPrincipalName.

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

-ResultSize

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

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

-Trustee

Le paramètre Trustee filtre les résultats en fonction de l’utilisateur ou du groupe disposant des autorisations Envoyer en tant que. Vous pouvez spécifier les types d’utilisateurs ou de groupes suivants :

  • 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 électronique
  • Nom d’utilisateur principal (UPN)

Vous devez utiliser ce paramètre avec les paramètres Identity, PrimarySmtpAddress, UserPrincipalName ou ExternalDirectoryObjectId.

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

-UserPrincipalName

Le paramètre UserPrincipalName identifie le destinataire que vous souhaitez afficher par UPN (par exemple, navin@contoso.onmicrosoft.com).

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.

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