Freigeben über


New-App

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 New-App, um Apps für Outlook zu installieren.

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

Syntax

New-App
   [-Etoken <String>]
   [-Mailbox <MailboxIdParameter>]
   [-MarketplaceCorrelationID <String>]
   [-MarketplaceAssetID <String>]
   [-MarketplaceQueryMarket <String>]
   [-MarketplaceServicesUrl <String>]
   [-MarketplaceUserProfileType <String>]
   [-AllowReadWriteMailbox]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]
New-App
   [-FileData <Byte[]>]
   [-AllowReadWriteMailbox]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]
New-App
   [-FileStream <Stream>]
   [-AllowReadWriteMailbox]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]
New-App
   [-Url <Uri>]
   [-AllowReadWriteMailbox]
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-DownloadOnly]
   [-Enabled <Boolean>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Wenn die App für die gesamte Organisation aktiviert ist, können Benutzer die neue App aktivieren, wenn sie E-Mail- oder Kalenderelemente in Microsoft Outlook oder Outlook im Web anzeigen. Wenn eine installierte App nicht aktiviert ist, können Benutzer die App über Outlook im Web Optionen aktivieren. Ebenso können Administratoren installierte Apps über das Exchange Admin Center oder mithilfe des Cmdlets Enable-App oder Set-App aktivieren.

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

New-App -FileData ([System.IO.File]::ReadAllBytes('C:\Apps\FinanceTestApp.xml'))

In diesem Beispiel wird die App-Manifestdatei "Finance Test" installiert, die auf die lokale Festplatte kopiert wurde.

Beispiel 2

New-App -OrganizationApp -Url https://Server01.Contoso.com/apps/ContosoCRMApp/manifest.xml -ProvidedTo SpecificUsers -UserList "user1,user2,user3,user4,user5" -DefaultStateForUser Enabled

In diesem Beispiel wird die Datei "manifest.xml" für die Contoso CRM-App von einer URL im Unternehmensnetzwerk von Contoso installiert. Der Exchange-Server muss die Ziel-URL erreichen können. Diese App ist als Organisations-App installiert, steht für eine bestimmte Liste von Benutzern zur Verfügung und wird für diese Benutzer standardmäßig aktiviert.

Parameter

-AllowReadWriteMailbox

Die Option AllowReadWriteMailbox gibt an, ob die App die Berechtigung „Postfach lesen/schreiben“ zulässt. 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 einer Organisations-App an. Gültige Werte sind:

  • Enabled: Die Organisations-App ist standardmäßig aktiviert.
  • Disabled: Die Organisations-App ist standardmäßig deaktiviert. Dies ist der Standardwert.
  • AlwaysEnabled: Die Organisations-App ist aktiviert, und Benutzer können sie nicht deaktivieren.

Sie müssen die Option OrganizationApp wählen, wenn Sie diesen Parameter verwenden.

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

-DownloadOnly

Die Option DownloadOnly gibt an, ob die App-Manifestdatei abgerufen und der Benutzer zur Bestätigung aufgefordert wird, bevor die Installation tatsächlich ausgeführt wird. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie diesen Switch verwenden, lädt das Cmdlet nur die App-Manifestdatei herunter und zeigt die App-Eigenschaften an, ohne die App zu installieren.

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, Exchange Online Protection

-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 steht für die angegebenen Benutzer zur Verfügung. Dies ist der Standardwert.
  • $false: Die App ist von allen Benutzern in der Organisation ausgeblendet.

Diese Einstellung überschreibt die Einstellungen ProvidedTo, UserList und DefaultStateForUser. 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

-Etoken

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String
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

-FileData

Der Parameter FileData gibt den Speicherort der App-Manifestdatei an. Sie dürfen nur einen Quellspeicherort für die App-Manifestdatei angeben. Sie können die App-Manifestdatei mithilfe des Parameters MarketplaceServicesUrl, Url oder FileData angeben.

Ein gültiger Wert für diesen Parameter erfordert, dass Sie die Datei mithilfe der folgenden Syntax in ein bytecodiertes Objekt lesen: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Sie können diesen Befehl als Parameterwert verwenden, oder Sie können die Ausgabe in eine Variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) schreiben und die Variable als Parameterwert ($data) verwenden.

Type:Byte[]
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

-FileStream

Der FileStream-Parameter wird nur vom Exchange Admin Center verwendet, um den App-Dateiuploader zu unterstützen. Verwenden Sie diesen Parameter nicht, um die App-Manifestdatei anzugeben. Sie können die App-Manifestdatei mithilfe des Parameters MarketplaceServicesUrl, URL oder FileData angeben.

Type:Stream
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

-Mailbox

Der Parameter Mailbox gibt das Postfach an, in dem Sie die App installieren möchten. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Zum Beispiel: 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)
Type:MailboxIdParameter
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

-MarketplaceAssetID

Der Parameter MarketplaceAssetID gibt den Office Store-Bezeichner für die App an. Sie müssen diesen Parameter verwenden, wenn Sie den Parameter MarketplaceServicesUrl verwenden.

Type:String
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

-MarketplaceCorrelationID

Der Parameter MarketplaceCorrelationID gibt den Office Store-Korrelationsbezeichner für die App an.

Type:String
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, Exchange Online Protection

-MarketplaceQueryMarket

Der Parameter MarketplaceQueryMarket gibt das Gebietsschema an, unter dem sich eine App bei Office Marketplace befindet. Eine App für den US-amerikanischen Markt in englischer Sprache verwendet den Wert en-US. Der Standardwert ist en-US.

Type:String
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

-MarketplaceServicesUrl

Der Parameter MarketplaceServicesUrl gibt die vollständige Dienste-URL für die App an. Sie dürfen nur einen Quellspeicherort für die App-Manifestdatei angeben. Sie können die App-Manifestdatei mithilfe des Parameters MarketplaceServicesUrl, URL oder FileData angeben.

Type:String
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

-MarketplaceUserProfileType

Der Parameter MarketplaceUserProfileType gibt den Benutzerprofiltyp für den Office Store an.

Type:String
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, 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 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PrivateCatalog

Die Option PrivateCatalog gibt an, ob sich die App in einem privaten Katalog befindet. 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 Server 2016, Exchange Server 2019, Exchange Online

-ProvidedTo

Der Parameter ProvidedTo gibt die Verfügbarkeit der App innerhalb Ihrer Organisation an. Gültige Werte sind:

  • Jeder: Dies ist der Standardwert. Diese App wird für jeden Benutzer in der Organisation bereitgestellt. 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

-Url

Der Parameter Url gibt die vollständige URL-Adresse der App-Manifestdatei an, die Sie installieren möchten. Sie dürfen nur einen Quellspeicherort für die App-Manifestdatei angeben. Sie können die App-Manifestdatei mithilfe des Parameters MarketplaceServicesUrl, URL oder FileData angeben.

Hinweis: URLs mit Umleitungen werden in Exchange Server 2016, Exchange Server 2019 und Exchange Online nicht unterstützt. Verwenden Sie eine direkte URL zum Manifest.

Type:Uri
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

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

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.