Get-EXOMailboxFolderPermission

Module:
Exchange PowerShell

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

Utilisez l’applet de commande Get-ExOMailboxFolderPermission pour afficher les autorisations au niveau des dossiers 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 une autorisation de niveau 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 renvoie 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 l’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 nécessaire pour renvoyer les 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 des performances optimales, nous vous recommandons d’utiliser l’identifiant utilisateur ou le nom d’utilisateur principal (UPN) pour identifier la boîte aux lettres.

Dans le cas contraire, vous pouvez utiliser n’importe quelle valeur identifiant 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.

Attention : La valeur $null ou une valeur inexistante pour le paramètre Identity renvoie 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 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’est pas autorisé à accéder au dossier de boîte aux lettres, la commande renvoie 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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.