Partager via

Get-EXORecipientPermission

Module:
Exchange PowerShell

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 dans un organization cloud.

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) 

Get-EXORecipientPermission

    [-AccessRights <MultiValuedProperty>]
    [-ResultSize <Unlimited>]
    [-Trustee <String>]
    [<CommonParameters>]

Identity 

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’un organization 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 être 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 être 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

Applicable : Exchange Online

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

Propriétés des paramètres

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:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExternalDirectoryObjectId

Applicable : Exchange Online

Le paramètre ExternalDirectoryObjectId identifie le destinataire que vous souhaitez afficher par objectId dans Microsoft Entra ID.

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

Propriétés des paramètres

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

Jeux de paramètres

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

-Identity

Applicable : Exchange Online

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.

Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.

Propriétés des paramètres

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

Jeux de paramètres

Identity
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PrimarySmtpAddress

Applicable : Exchange Online

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.

Propriétés des paramètres

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

Jeux de paramètres

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

-ResultSize

Applicable : Exchange Online

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.

Propriétés des paramètres

Type:Unlimited
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:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Trustee

Applicable : Exchange Online

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.

Propriétés des paramètres

Type:String
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:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UserPrincipalName

Applicable : Exchange Online

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.

Propriétés des paramètres

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

Jeux de paramètres

Identity
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
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.