Partager via

Get-EXOMailboxFolderPermission

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-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.

Syntaxe

Default (Par défaut) 

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

Applicable : Exchange Online

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

Type:Guid
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é:True
Valeur des arguments restants:False

-GroupMailbox

Applicable : Exchange Online

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.

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

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 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.

Propriétés du paramètre

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: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 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.

Propriétés du paramètre

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é:True
Valeur des arguments restants:False

-User

Applicable : Exchange Online

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 retourne une erreur.

Propriétés du paramètre

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 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.

Propriétés du paramètre

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é: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.