Set-App

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

Verwenden Sie das Cmdlet Set-App, um die Verfügbarkeit von Organisationsapps zu ändern.

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

Syntax

Set-App
   [-Identity] <AppIdParameter>
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-App kann nur verwendet werden, wenn Sie die Verfügbarkeit einer Organisations-App konfigurieren. Diese Aufgabe erfordert, dass die angegebene App bereits installiert wurde (z. B. dass die App mit dem Cmdlet New-App installiert wurde oder dass es sich um eine Standard-App für Outlook handelt).

Standard-Apps in Outlook im Web und Apps, die Sie zur Verwendung durch Benutzer in Ihrer Organisation installiert haben, werden als Organisations-Apps bezeichnet. Organisations-Apps können nicht von Endbenutzern entfernt, jedoch aktiviert oder deaktiviert werden. Wenn es sich bei einer App um eine Organisations-App handelt (standardmäßig bereitgestellt oder innerhalb der Organisation installiert), ist das Bedienelement zum Löschen der App auf der Symbolleiste für Endbenutzer deaktiviert. Administratoren können Organisations-Apps entfernen. Standard-Apps können zwar nicht von Administratoren entfernt, jedoch für die gesamte Organisation deaktiviert werden.

Weitere Informationen finden Sie unter Verwalten des Benutzerzugriffs auf Add-Ins für Outlook in Exchange Server und Verwalten der Bereitstellung von Add-Ins im Microsoft 365 Admin Center.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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

$a= Get-DistributionGroupMember -Identity "Finance Team"

Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -ProvidedTo SpecificUsers -UserList $a.Identity -DefaultStateForUser Enabled

In diesem Beispiel wird die Organisations-App „FinanceTestApp“, die für sämtliche Mitarbeiter in der Organisation installiert wurde, so geändert, dass sie für Benutzer in der Finanzabteilung bereitgestellt und standardmäßig aktiviert wird.

Beispiel 2

Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -Enabled $false

In diesem Beispiel wird die Organisations-App „FinanceTestApp“ innerhalb der Organisation deaktiviert und nicht länger für Endbenutzer angezeigt.

Parameter

-Confirm

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

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DefaultStateForUser

Der Parameter DefaultStateForUser gibt den standardmäßigen Anfangszustand der Organisations-App für die angegebenen Benutzer an. Gültige Werte sind:

  • Enabled: Die Organisations-App ist aktiviert.
  • Disabled: Die Organisations-App ist deaktiviert. Dies ist der Standardwert.
  • AlwaysEnabled: Die Organisations-App ist aktiviert, und die Benutzer können diese nicht deaktivieren.

Verwenden Sie diesen Parameter mit der Option OrganizationApp.

Type:DefaultStateForUser
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Der Parameter Enabled gibt an, ob die App für Benutzer in der Organisation verfügbar ist. Gültige Werte sind:

  • $true: Die App ist für die angegebenen Benutzer aktiviert. Dies ist der Standardwert.
  • $false: Die App wird für keinen Benutzer in der Organisation aktiviert. Dadurch wird die App in der Benutzeransicht für alle Benutzer ausgeblendet.

Diese Einstellung setzt die Einstellungen ProvidedTo, UserList und DefaultStateForUser außer Kraft. Durch diese Einstellung wird nicht verhindert, dass Benutzer eine eigene Instanz der App installieren, wenn sie über Installationsberechtigungen verfügen.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

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

Type:AppIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationApp

Die Option OrganizationApp gibt an, dass die App für eine Organisation bestimmt ist und nicht an einen bestimmten Benutzer gebunden ist. Sie müssen bei dieser Option keinen Wert angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PrivateCatalog

Der Schalter PrivateCatalog gibt an, dass sich die App, die Sie ändern möchten, in einem privaten Katalog befindet. Sie müssen bei dieser Option keinen Wert angeben.

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

-ProvidedTo

Der Parameter ProvidedTo gibt die Verfügbarkeit der App innerhalb Ihrer Organisation an. Der gültige Wert ist:

  • Jeder: Die App wird für jeden Benutzer in der Organisation bereitgestellt. Dies ist der Standardwert. Jedem Benutzer wird diese App in der Liste der installierten Apps in Outlook im Web Optionen aufgeführt. Wenn eine App in der Liste der installierten Apps aktiviert ist, können Benutzer die Features dieser App in ihrer E-Mail verwenden. Alle Benutzer werden daran gehindert, ihre eigenen Instanzen dieser App zu installieren, einschließlich, aber nicht beschränkt auf Benutzer mit Berechtigungen zum Installieren von Apps.
  • SpecificUsers: Diese App wird nur für Benutzer bereitgestellt, die durch den Parameter UserList angegeben wurden. Alle anderen Benutzer können diese Organisations-App weder in ihrer Verwaltungsansicht anzeigen noch in ihrer E-Mail oder in den Kalenderelementen aktivieren. Die angegebenen Benutzer können keine eigene Instanz dieser App installieren. Die Installation einer eigenen Instanz dieser App wird für nicht aufgelistete Benutzer nicht blockiert.

Verwenden Sie diesen Parameter mit der Option OrganizationApp.

Type:ClientExtensionProvidedTo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-UserList

Der Parameter UserList gibt an, wer eine Organisations-App verwenden kann. Dieser Parameter ist auf 1.000 Benutzer beschränkt. Im cloudbasierten Dienst ist dieser Wert weniger relevant, da die Office-Add-In-Verwaltung in die zentrale Bereitstellung übergeht.

Gültige Werte sind Postfächer oder E-Mail-Benutzer in Ihrer Organisation. Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. 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)

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN". Die maximale Größe der Liste beträgt 1.000 Empfänger.

Verwenden Sie diesen Parameter mit der Option OrganizationApp.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.