Erstellen von Apps mit PowerShell

Gilt für: Entwickler-Mandantenadministrator — SharePoint Embedded-Administrator/Globaler Administrator

Verwenden Sie SharePoint PowerShell, um SharePoint Embedded-Containertypen für Apps zu erstellen. Jeder Containertyp wird einer Microsoft Entra-Anwendung zugeordnet.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Die Rolle "SharePoint Embedded-Administrator" oder "Globaler Administrator".
  • Die neueste SharePoint Online-Verwaltungsshell.
  • Die ID der Microsoft Entra-Anwendung, die den Containertyp besitzt.
  • Für die Standardabrechnungseinrichtung Berechtigungen "Besitzer" oder "Mitwirkender" für das Azure-Abonnement.

Wichtig

Wählen Sie beim Erstellen des Containertyps die Abrechnungsmethode aus. Sie können die Abrechnungsmethode nach der Erstellung nicht mehr ändern.

Erstellen einer standardmäßigen abgerechneten App

Verwenden Sie die Standardabrechnung, wenn die organization, die Besitzer der App ist, für die Nutzung von SharePoint Embedded bezahlt.

New-SPOContainerType -ContainerTypeName <ContainerTypeName> -OwningApplicationId <OwningApplicationId>

Richten Sie die Abrechnung für den Standardcontainertyp ein, indem Sie ein Azure-Abonnement, eine Ressourcengruppe und eine Region zuweisen.

Add-SPOContainerTypeBilling -ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

Erstellen einer Pass-Through-App mit Abrechnung

Verwenden Sie die Pass-Through-Abrechnung, wenn der nutzende Mandant für die SharePoint Embedded-Nutzung bezahlt.

New-SPOContainerType -IsPassThroughBilling -ContainerTypeName <ContainerTypeName> -OwningApplicationId <OwningApplicationId>

Für die Pass-Through-Abrechnung muss der nutzende Mandantenadministrator Microsoft 365-Dienste mit nutzungsbasierter Bezahlung einrichten, bevor Benutzer auf die App zugreifen können. Weitere Informationen finden Sie unter Einrichten der Abrechnung im Microsoft 365 Admin Center.

Test-App erstellen

Verwenden Sie eine Test-App für Evaluierungs- und Machbarkeitsnachweise.

New-SPOContainerType -TrialContainerType -ContainerTypeName <ContainerTypeName> -OwningApplicationId <OwningApplicationId>

Test-Apps sind 30 Tage lang gültig.

Apps anzeigen

Auflisten von SharePoint Embedded-Apps, die im besitzenden Mandanten erstellt wurden.

Get-SPOContainerType
Get-SPOContainerType -ContainerTypeId <ContainerTypeId>

Get-SPOContainerTypeüberprüft den Zugriff in Azure, bevor das Abrechnungsabonnement, die Ressourcengruppe und die Region für einen Containertyp mit Standardabrechnung angezeigt werden. Für das angemeldete Konto benötigen Sie die Microsoft.Resources/subscriptions/read Berechtigung für den verknüpften Azure-Abonnementbereich. Die Rollen "Azure Leser", "Mitwirkender" und "Besitzer" enthalten diese Berechtigung.

Ohne diese Azure-Berechtigung gibt das Cmdlet weiterhin den Containertyp zurück. Allerdings werden die Abrechnungsdetails weggelassen und eine Berechtigungsmeldung angezeigt. Die Rollen "SharePoint Embedded-Administrator" und "Globaler Administrator" gewähren keinen Zugriff auf das Azure-Abonnement.

Der Lesezugriff ist ausreichend, um die Abrechnungsdetails anzuzeigen. Der Zugriff des Besitzers oder Mitwirkenden ist erforderlich, um die Abrechnungsbeziehung hinzuzufügen oder zu ändern.

Aktualisieren von App-Eigenschaften

Aktualisieren der unterstützten Containertypeigenschaften

Set-SPOContainerType -ContainerTypeId <ContainerTypeId>
                     [-ContainerTypeName <ContainerTypeName>]
                     [-WhatIf] [-Confirm]

Konfigurieren des App-Verhaltens

Konfigurieren Sie Einstellungen für unterstützte Containertypen, z. B. Auffindbarkeit und Freigabeeinschränkungen.

Set-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId> -DiscoverabilityDisabled $true
Set-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId> -SharingRestricted $true

Aktuelle Konfiguration anzeigen.

Get-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId>

Verwandte Inhalte

Nächste Schritte

Installieren Sie die App im Mandanten: Installieren Sie eine SharePoint Embedded-App.

  • Last updated on