Criar aplicativos com o PowerShell

Aplica-se a: Administrador de locatários do desenvolvedor — Administrador do SharePoint Embedded/Administrador global

Use o PowerShell do SharePoint para criar tipos de contêiner incorporados do SharePoint para aplicativos. Cada tipo de contêiner é mapeado para um aplicativo do Microsoft Entra.

Antes de começar

Verifique se você tem:

  • A função de Administrador Integrado do SharePoint ou Administrador Global.
  • O mais recente Shell de Gerenciamento do SharePoint Online.
  • A ID do aplicativo Microsoft Entra que possui o tipo de contêiner.
  • Para configuração de cobrança padrão, permissões de proprietário ou contribuidor na assinatura do Azure.

Importante

Escolha o método de cobrança ao criar o tipo de contêiner. Você não pode alterar o método de cobrança após a criação.

Criar um aplicativo de cobrança padrão

Use a cobrança padrão quando a organização proprietária do aplicativo pagar pelo uso do SharePoint Embedded.

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

Configure a cobrança para o tipo de contêiner padrão atribuindo uma assinatura do Azure, um grupo de recursos e uma região.

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

Criar um aplicativo de cobrança de passagem

Use a cobrança de passagem quando o locatário consumidor pagar pelo uso do SharePoint Embedded.

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

Para cobrança de passagem, o administrador de locatários consumidor deve configurar os serviços de pagamento conforme o uso do Microsoft 365 antes que os usuários possam acessar o aplicativo. Para obter mais informações, consulte Configurar cobrança no Centro de administração do Microsoft 365.

Criar um aplicativo de avaliação

Use um aplicativo de avaliação para avaliação e trabalho de prova de conceito.

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

Os aplicativos de avaliação são válidos por 30 dias.

Exibir aplicativos

Listar os aplicativos incorporados do SharePoint criados no locatário proprietário.

Get-SPOContainerType
Get-SPOContainerType -ContainerTypeId <ContainerTypeId>

Get-SPOContainerTypeverifica o acesso ao Azure antes de exibir a assinatura de cobrança, o grupo de recursos e a região para um tipo de contêiner de cobrança padrão. A conta conectada precisa Microsoft.Resources/subscriptions/read da permissão no escopo da assinatura do Azure vinculada. As funções de Leitor, Colaborador e Proprietário do Azure incluem essa permissão.

Sem essa permissão do Azure, o cmdlet ainda retorna o tipo de contêiner. No entanto, ele omite os detalhes de cobrança e exibe uma mensagem de permissões. As funções de Administrador Integrado e Administrador Global do SharePoint não concedem acesso à assinatura do Azure.

O acesso de leitor é suficiente para exibir os detalhes de cobrança. O acesso de Proprietário ou Colaborador é necessário para adicionar ou alterar a relação de cobrança.

Atualizar propriedades do aplicativo

Atualizar as propriedades de tipo de contêiner com suporte.

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

Configurar o comportamento do aplicativo

Configure as configurações de tipo de contêiner com suporte, como restrições de descoberta e compartilhamento.

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

Exibir a configuração atual.

Get-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId>

Conteúdo relacionado

Próximas etapas

Instale o aplicativo no locatário: Instale um aplicativo incorporado do SharePoint.

  • Last updated on