Remove-App

 

Gilt für:Exchange Online, Exchange Server 2016

Letztes Änderungsdatum des Themas:2018-01-16

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im Cloud-basierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Remove-App, um eine App zu deinstallieren.

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

Remove-App -Identity <AppIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>] [-OrganizationApp <SwitchParameter>] [-PrivateCatalog <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

In diesem Beispiel wird die Finanztest-App entfernt, die für den Benutzer "Tony" installiert wurde.

Remove-App -Identity <GUID for FinanceTestApp> -Mailbox Tony

Weitere Informationen finden Sie unter Installieren oder Entfernen von Apps für Outlook für Ihre Organisation.

Das Cmdlet Remove-App erfordert, dass die angegebene App bereits installiert wurde (z. B. mit dem Cmdlet New-App). Standardmäßig installierte Apps können nicht deinstalliert, aber deaktiviert werden.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Apps für Outlook" im Thema Empfängerberechtigungen.

 

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.AppIdParameter

Der Parameter Identity gibt die AppID (GUID-Wert) der App an, die Sie entfernen möchten. Um den GUID-Wert einer App zu finden, führen Sie den Befehl Get-App | Format-Table -Auto DisplayName,AppId aus.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Switch Confirm gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie dieser Switch sich auf das Cmdlet auswirkt, hängt davon ab, ob für den Switch vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pausefunktion, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie mithilfe der exakt folgenden Syntax die Bestätigungsaufforderung überspringen: -Confirm:$false.

  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pausefunktion. Bei diesen Cmdlets führt das Angeben des Confirm-Switches ohne einen Wert eine Pausefunktion ein, wodurch Sie gezwungen werden, den Befehl zu bestätigen, bevor Sie fortfahren.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter ist nur in der lokalen Exchange-Bereitstellung 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. Zum Beispiel dc01.contoso.com.

Mailbox

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Parameter Mailbox gibt die Identität des Postfachs oder E-Mail-Benutzers an. Folgende Werte können verwendet werden:

  • GUID

  • Distinguished Name (DN)

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • Legacy-Exchange-DN

  • SMTP-Adresse

  • Alias

OrganizationApp

Optional

System.Management.Automation.SwitchParameter

Der Parameter OrganizationApp gibt an, dass es sich um eine Organisationsapp handelt. Dieser Parameter ist standardmäßig auf $false festgelegt. Dieser Parameter ist erforderlich, wenn die Ziel-App für die Organisation installiert wird.

PrivateCatalog

Optional

System.Management.Automation.SwitchParameter

Die Option PrivateCatalog gibt an, dass sich die App, die Sie entfernen möchten, in einem privaten Katalog befindet. Sie müssen keinen Wert für diese Option angeben.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Switch WhatIf simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: