Share via

Get-EXOMailboxFolderPermission

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online

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-ExOMailboxFolderPermission pour afficher les autorisations au niveau du dossier dans les boîtes aux lettres.

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-EXOMailboxFolderPermission
   [[-Identity] <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-GroupMailbox]
   [-PrimarySmtpAddress <String>]
   [-User <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour récupérer l’autorisation au niveau du dossier dans la boîte aux lettres.

Exemples

Exemple 1

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports

Cet exemple renvoie la liste actuelle des autorisations de l'utilisateur pour le sous-dossier de rapports dans le dossier Marketing qui se trouve dans la boîte aux lettres de John.

Exemple 2

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports -User Kim@contoso.com

Cet exemple retourne les autorisations pour le même dossier dans la boîte aux lettres de John, mais uniquement pour l’utilisateur Kim.

Paramètres

-ExternalDirectoryObjectId

Le paramètre ExternalDirectoryObjectId identifie la boîte aux lettres 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

-GroupMailbox

Le commutateur GroupMailbox est requis pour retourner Groupes Microsoft 365 dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
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 dossier de boîte aux lettres que vous souhaitez afficher. Ce paramètre utilise la syntaxe : <Mailbox>:\<Folder>. Pour de meilleures performances, nous vous recommandons d’utiliser l’ID d’utilisateur ou le nom d’utilisateur principal (UPN) pour identifier la boîte aux lettres.

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
  • Nom unique
  • 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 la boîte aux lettres 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

-User

Le paramètre User filtre les résultats en fonction de la boîte aux lettres spécifiée, de l’utilisateur de messagerie ou du groupe de sécurité à extension messagerie (principal de sécurité) disposant d’autorisations pour le dossier de boîte aux lettres. 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
  • Nom unique canonique
  • GUID

Remarque : Si vous spécifiez un utilisateur qui n’a pas l’autorisation d’accéder au dossier de boîte aux lettres, la commande lève une exception.

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 la boîte aux lettres 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