Get-EXOMailboxFolderPermission

Modul:
Exchange PowerShell

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

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

Default (Standard) 

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

Beschreibung

Verwenden Sie dieses Cmdlet, um die Berechtigung auf Ordnerebene für das 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

Dieses Beispiel gibt die Berechtigungen für denselben Ordner in Johns Postfach zurück, jedoch nur für den Benutzer Kim.

Parameter

-ExternalDirectoryObjectId

Anwendbar: Exchange Online

Der Parameter ExternalDirectoryObjectId identifiziert das Postfach, das Sie anzeigen möchten, anhand der ObjectId in Microsoft Entra ID.

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

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-GroupMailbox

Anwendbar: Exchange Online

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Anwendbar: Exchange Online

Der Identity-Parameter gibt das Postfachordner an, den Sie anzeigen möchten. Dieser Parameter verwendet die Syntax: <Mailbox>:\<Folder>. Um eine optimale Leistung zu erzielen, empfehlen wir die Verwendung der Benutzer-ID oder des Benutzerprinzipalnamens (UPN) zur Identifizierung des Postfachs.

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.

Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PrimarySmtpAddress

Anwendbar: Exchange Online

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-User

Anwendbar: Exchange Online

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 zum Zugriff auf den Postfachordner verfügt, gibt der Befehl einen Fehler zurück.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserPrincipalName

Anwendbar: Exchange Online

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

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.