Get-EXOMailboxFolderPermission

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Online

Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul verfügbar. Weitere Informationen finden Sie unter Informationen zum Exchange Online PowerShell-Moduls.

Verwenden Sie das Cmdlet Get-ExOMailboxFolderPermission, um Berechtigungen auf Ordnerebene in Postfächern anzuzeigen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-EXOMailboxFolderPermission
   [[-Identity] <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-GroupMailbox]
   [-PrimarySmtpAddress <String>]
   [-User <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die Berechtigung auf Ordnerebene im Postfach abzurufen.

Beispiele

Beispiel 1

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

In diesem Beispiel wird die aktuelle Liste der Berechtigungen eines Benutzers für den Unterordner „Reports“ im Ordner „Marketing“ in Johns Postfach zurückgegeben.

Beispiel 2

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

In diesem Beispiel werden die Berechtigungen für denselben Ordner in Johns Postfach zurückgegeben, jedoch nur für den Benutzer Kim.

Parameter

-ExternalDirectoryObjectId

Der Parameter ExternalDirectoryObjectId identifiziert das Postfach, das Sie anzeigen möchten, anhand der ObjectId in Azure Active Directory.

Sie können diesen Parameter nicht mit den Parametern Identity, PrimarySmtpAddress oder UserPrincipalName verwenden.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-GroupMailbox

Der GroupMailbox-Switch ist erforderlich, um Microsoft 365-Gruppen in den Ergebnissen zurückzugeben. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Der Identity-Parameter gibt das Postfachordner an, den Sie anzeigen möchten. Für diesen Parameter wird die Syntax verwendet: <Mailbox>:\<Folder>. Für eine optimale Leistung empfehlen wir die Verwendung der Benutzer-ID oder des Benutzerprinzipalnamens (UPN), um das Postfach zu identifizieren.

Andernfalls können Sie einen beliebigen Wert verwenden, der das Postfach eindeutig identifiziert. Zum Beispiel:

  • Name
  • Alias
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • LegacyExchangeDN
  • SamAccountName

Sie können diesen Parameter nicht mit den Parametern ExternalDirectoryObjectId, PrimarySmtpAddress oder UserPrincipalName verwenden.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-PrimarySmtpAddress

PrimarySmtpAddress identifiziert das Postfach, das Sie anzeigen möchten, anhand der primären SMTP-E-Mail-Adresse (z. B navin@contoso.com. ).

Sie können diesen Parameter nicht mit den Parametern ExternalDirectoryObjectId, Identity oder UserPrincipalName verwenden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-User

Der Parameter User filtert die Ergebnisse nach dem angegebenen Postfach, dem E-Mail-Benutzer oder der E-Mail-aktivierten Sicherheitsgruppe (Sicherheitsprinzipal), das/der/die eine Berechtigung für den Postfachordner erteilt hat. Sie können einen beliebigen Wert verwenden, der den Benutzer oder die Gruppe eindeutig identifiziert. Beispiel:

  • Name
  • Alias
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • Kanonischer DN
  • GUID

Hinweis: Wenn Sie einen Benutzer angeben, der nicht über die Berechtigung für den Zugriff auf den Postfachordner verfügt, löst der Befehl eine Ausnahme aus.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

Der Parameter UserPrincipalName identifiziert das Postfach, das Sie nach UPN anzeigen möchten (z. B navin@contoso.onmicrosoft.com. ).

Sie können diesen Parameter nicht mit den Parametern ExternalDirectoryObjectId, Identity oder PrimarySmtpAddress verwenden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online