Remove-MailboxPermission

Modul:: Exchange PowerShell

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen sind möglicherweise exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Remove-MailboxPermission, um Berechtigungen aus dem Postfach eines Benutzers oder einem E-Mail-Benutzer mit Exchange Server 2016, Exchange Server 2019 oder Exchange Online zu entfernen.

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

Syntax

AccessRights

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    -AccessRights <MailboxRights[]>
    -User <SecurityPrincipalIdParameter>
    [-BypassMasterAccountSid]
    [-Confirm]
    [-Deny]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-InheritanceType <ActiveDirectorySecurityInheritance>]
    [-SoftDeletedMailbox]
    [-WhatIf]
    [<CommonParameters>]

Instance

Remove-MailboxPermission
    [[-Identity] <MailboxIdParameter>]
    -Instance <MailboxAcePresentationObject>
    [-AccessRights <MailboxRights[]>]
    [-Confirm]
    [-Deny]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-InheritanceType <ActiveDirectorySecurityInheritance>]
    [-User <SecurityPrincipalIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Owner

Remove-MailboxPermission
    [[-Identity] <MailboxIdParameter>]
    [-BypassMasterAccountSid]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

ClearAutoMapping

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    [-ClearAutoMapping]
    [-BypassMasterAccountSid]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

ResetDefault

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    [-ResetDefault]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-MailboxPermission ermöglicht es Ihnen, Berechtigungen für ein Benutzerpostfach zu entfernen, z. B. können Sie einem Benutzer den Vollzugriff auf das Postfach eines anderen Benutzers entziehen.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Remove-MailboxPermission -Identity "Yuuto Sasaki" -User "Pedro Pizarro" -AccessRights FullAccess -InheritanceType All

In diesem Beispiel wird Pedro Pizarros Vollzugriffsberechtigung auf das Postfach von Yuuto Sasaki entfernt.

Beispiel 2

Remove-MailboxPermission -Identity "HR Project" -ClearAutoMapping

In Exchange Online schließt dieses Beispiel das HR-Projektpostfach für alle Benutzer mit Vollzugriffsberechtigung für das Postfach von der automatischen Zuordnung in Outlook aus.

Parameter

-AccessRights

Der Parameter AccessRights gibt die Berechtigung an, die Sie dem Benutzer für das Postfach entziehen möchten. Gültige Werte sind:

FullAccess
SendAs
ExternalAccount
DeleteItem
ReadPermission
ChangePermission
ChangeOwner

Es können mehrere Werte durch Kommata getrennt angegeben werden.

Parametereigenschaften

Typ:	MailboxRights[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

AccessRights

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

Instance

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

-BypassMasterAccountSid

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Schalter BypassMasterAccountSid unterdrückt den folgenden Fehler: Can't remove the access control entry on the object "User" for the user account because the ACE doesn't exist on the object. Bei diesem Schalter müssen Sie keinen Wert angeben.

In der Regel müssen Sie diese Option nur in Office 365 Dediz- oder ITAR Legacy-Umgebungen verwenden.

Parametereigenschaften

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

Parametersätze

AccessRights

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

Owner

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

ClearAutoMapping

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

-ClearAutoMapping

Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.

Der ClearAutoMapping-Parameter schließt das Postfach aus dem Feature für die automatische Zuordnung in Microsoft Outlook aus. Sie müssen keinen Wert für diese Option angeben.

Die automatische Zuordnung verwendet die AutoErmittlung, um dem Outlook-Profil eines Benutzers automatisch Postfächer hinzuzufügen, wenn der Benutzer über die Berechtigung „Vollzugriff“ für das Postfach verfügt. Verwenden Sie diese Option, um dieses Postfach von der automatischen Zuordnung für alle Benutzer auszuschließen, die über die Berechtigung "Vollzugriff" für das Postfach verfügen.

Sie können diese Option nicht mit den Parametern "Benutzer" oder "Zugriffsrechte" verwenden.

Hinweis: Wenn Sie diesen Schalter in einem Remove-MailboxPermission Befehl verwenden, das Postfach jedoch nicht von der automatischen Zuordnung für einen Benutzer ausgeschlossen wird, entfernen Sie die Vollzugriffsberechtigung des Benutzers, indem Sie das Cmdlet Remove-MailboxPermission mit dem Parameter User verwenden. Weisen Sie dann die Vollzugriffsberechtigung des Benutzers für das Postfach mithilfe des Add-MailboxPermission-Cmdlets erneut zu, wobei der Parameter AutoMapping auf den Wert $false festgelegt ist.

Parametereigenschaften

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

Parametersätze

ClearAutoMapping

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

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

Parametereigenschaften

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

Parametersätze

(All)

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

-Deny

Die Option "Verweigern" gibt an, dass die Berechtigungen, die Sie entfernen, Berechtigungen verweigern sind. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

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

Parametersätze

AccessRights

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

Instance

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

-DomainController

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Parametereigenschaften

Typ:	Fqdn
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

-GroupMailbox

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Die Option "GroupMailbox" ist erforderlich, um Berechtigungen aus einem Microsoft 365 Gruppenpostfach zu entfernen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

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

Parametersätze

AccessRights

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

Owner

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

Instance

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

-Identity

Der Parameter Identity gibt das Postfach an, aus dem Sie Berechtigungen entfernen. Sie können einen beliebigen Wert verwenden, der das Postfach eindeutig identifiziert: Beispiel:

Name
Alias
Distinguished Name (DN)
Distinguished Name (DN)
Domäne\Benutzername
E-Mail-Adresse
GUID
LegacyExchangeDN
SamAccountName
Benutzer-ID oder User Principal Name (UPN)

Parametereigenschaften

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

Parametersätze

AccessRights

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

Owner

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

ClearAutoMapping

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

ResetDefault

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IgnoreDefaultScope

De Schalter IgnoreDefaultScope weist den Befehl an, die Standardeinstellung für den Empfängerbereich für die Exchange PowerShell-Sitzung zu ignorieren und die komplette Gesamtstruktur als Bereich zu verwenden. Sie müssen keinen Wert für diese Option angeben.

Dieser Switch ermöglicht dem Befehl den Zugriff auf Active Directory-Objekte, die derzeit nicht im Standardbereich verfügbar sind, führt aber auch die folgenden Einschränkungen ein:

Sie können den Parameter DomainController nicht verwenden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.
Sie können nur den DN für den Identitätsparameter verwenden. Andere Formen der Identifikation wie Aliasnamen oder GUIDs werden nicht akzeptiert.

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

-InheritanceType

Der Parameter InheritanceType gibt an, ob Berechtigungen innerhalb des Postfachs an Ordner vererbt werden. Gültige Werte sind:

Keine
Alle (dies ist der Standardwert)
Untergeordnetes Element
Nachkommen [sic]
SelfAndChildren

Parametereigenschaften

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

Parametersätze

AccessRights

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

Instance

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

-Instance

Dieser Parameter ist im lokalen Exchange verfügbar.

The Instance parameter enables you to pass an entire object to the command to be processed. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

Parametereigenschaften

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

Parametersätze

Instance

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

-ResetDefault

Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.

Der Schalter "ResetDefault" setzt die Standardsicherheitsbeschreibung des Postfachs zurück. Sie müssen keinen Wert für diese Option angeben.

Berechtigungen für das Postfach werden zurückgesetzt, sodass nur der Postfachbesitzer über die Berechtigung "Vollzugriff" für das Postfach verfügt. Die folgenden Arten von Berechtigungen sind nicht betroffen:

Empfängerberechtigungen (z. B. SendAs, SendOnBehalf und Stellvertretungen).
Berechtigungen für Postfachordner, die unter Verwendung der MailboxFolderPermission-Cmdlets erteilt wurden.
Berechtigungen für Postfachordner, die mithilfe von Outlook oder anderen MAPI-Clients zugewiesen wurden.

Da dieser Schalter die Vollzugriffsberechtigung anderer Benutzer auf dem Postfach entfernt, wird das Postfach nicht mehr automatisch von der AutoErmittlung den Outlook-Profilen anderer Benutzer zugeordnet.

Sie können diese Option nicht mit den Parametern Benutzer für Zugriffsrechte verwenden.

Parametereigenschaften

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

Parametersätze

Instance

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

-SoftDeletedMailbox

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Die Option "SoftDeletedMailbox" ist erforderlich, um Berechtigungen aus einem vorläufig gelöschten Postfach zu entfernen. Sie müssen keinen Wert für diese Option angeben.

Vorläufig gelöschte Postfächer sind gelöschte Postfächer, die noch wiederhergestellt werden können.

Parametereigenschaften

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

Parametersätze

AccessRights

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

-User

Der Parameter User gibt an, wessen Berechtigungen aus dem angegebenen Postfach entfernt werden. Sie können die folgenden Typen von Benutzern oder Gruppen (Sicherheitsprinzipale) für diesen Parameter angeben:

Postfachbenutzer
E-Mail-Benutzer
Sicherheitsgruppen

Um optimale Ergebnisse zu erzielen, empfehlen wir die Verwendung der folgenden Werte:

UPN: Zum Beispiel user@contoso.com (nur Benutzer).
Domain\SamAccountName: Beispiel: contoso\user.

Andernfalls können Sie einen beliebigen Wert verwenden, der den Benutzer oder die Gruppe eindeutig identifiziert. Zum Beispiel:

Name
Alias
Distinguished Name (DN)
Distinguished Name (DN)
Domäne\Benutzername
E-Mail-Adresse
GUID
LegacyExchangeDN
SamAccountName
Benutzer-ID oder User Principal Name (UPN)

Parametereigenschaften

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

Parametersätze

AccessRights

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

Instance

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

-WhatIf

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

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

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
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.

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Feedback

War diese Seite hilfreich?