Get-RecipientPermission
Cette cmdlet est disponible uniquement dans le service cloud.
La cmdlet Get-RecipientPermission permet d’afficher des informations sur les autorisations Envoyer en tant que configurées pour les utilisateurs dans une organisation en nuage.
Remarque : Dans Exchange Online PowerShell, nous vous recommandons d’utiliser l’applet de commande Get-EXORecipientPermission au lieu de cette applet de commande. Pour plus d’informations, reportez-vous à Connexion à Exchange Online.
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-RecipientPermission
[[-Identity] <RecipientIdParameter>]
[-AccessRights <MultiValuedProperty>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-Trustee <SecurityPrincipalIdParameter>]
[<CommonParameters>]
Description
Lorsqu’un utilisateur se voit attribuer une autorisation Envoyer en tant que vers un autre utilisateur ou groupe, l’utilisateur peut envoyer des messages semblant provenir de l’autre utilisateur ou groupe.
Remarque
Cette applet de commande ne retourne pas les résultats attendus lorsque le destinataire spécifié par le paramètre Trustee a plusieurs SecurityPrincipalIdParameter valeurs (Sid). Lorsque vous utilisez le paramètre Trustee, la commande compare le Sid de l’administrateur spécifié à l’enregistrement de liste de contrôle d’accès (ACL) du destinataire. Si certaines valeurs Sid du destinataire ont changé, il y a une incompatibilité. La solution de contournement consiste à ne pas utiliser la valeur de nom d’utilisateur principal (UPN), à utiliser tous les sids, y compris celui de l’historique.
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
Get-RecipientPermission -Trustee "Kim Akers"
Cet exemple répertorie les destinataires pour lesquels l’utilisateur « Kim Akers » dispose de l’autorisation Envoyer en tant que. Rosalie peut envoyer des messages semblant provenir directement des destinataires.
Exemple 2
Get-RecipientPermission "Help Desk"
Cet exemple répertorie les utilisateurs qui disposent de l’autorisation Envoyer en tant que sur la boîte aux lettres « Help Desk ». Les utilisateurs peuvent maintenant envoyer des messages qui semblent provenir directement de la boîte aux lettres du support technique.
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 |
-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 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
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: | 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: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ReadFromDomainController
Applicable : Exchange Online
Le paramètre ReadFromDomainController spécifie que les informations utilisateur sont lues à partir d’un contrôleur de domaine dans le domaine de l’utilisateur. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
-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 qui dispose des autorisations Envoyer en tant que sur le destinataire spécifié. 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 des paramètres
| 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: | 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.