Set-SPOApplication
Define ou atualiza uma ou mais configurações de um aplicativo incorporado do SharePoint.
Sintaxe
Default (Default)
Set-SPOApplication
[-OwningApplicationId] <Guid>
[[-SharingCapability] <SharingCapabilities>]
[[-OverrideTenantSharingCapability] <Boolean>]
[[-CopilotEmbeddedChatHosts] <System.Collections.Generic.List`1[System.String]>]
[[-ItemMajorVersionLimit] <Int>]
[<CommonParameters>]
Description
Set-SPOApplication cmdlet é usado para definir as propriedades de configuração de um aplicativo específico, determinado pelo OwningApplicationId.
Você deve ser um Administrador do SharePoint Embedded para executar esse cmdlet.
Observação
O OwningApplicationId para o Microsoft Loop é a187e399-0c36-4b98-8f04-1edc167a0996.
O OwningApplicationId para o Microsoft Designer é 5e2795e3-ce8c-4cfb-b302-35fe5cd01597.
Para convidar pessoas de fora da sua organização, verifique se o B2B do Microsoft Entra está habilitado.
Exemplos
Exemplo 1
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $false
Este exemplo desabilita o recurso de compartilhamento de substituição, alinhando as configurações de compartilhamento desse aplicativo incorporado do SharePoint com o recurso de compartilhamento do SharePoint Online.
Exemplo 2
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability Disabled
Este exemplo permite a substituição, restringindo o compartilhamento de arquivos no aplicativo SharePoint Embedded somente aos usuários internos da empresa, independentemente das configurações mais amplas do locatário do SharePoint Online.
Exemplo 3
Set-SPOTenant -EnableAzureADB2BIntegration $true
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability ExternalUserandGuestSharing
Este exemplo demonstra como habilitar o compartilhamento de arquivos no aplicativo SharePoint Embedded para usuários externos. Observe que a integração B2B deve ser habilitada para permitir convites de convidado para aplicativos incorporados do SharePoint.
Exemplo 4
Set-SPOApplication -OwningApplicationId 423poi45 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"
Este exemplo define as URLs de host para o aplicativo com a ID 423poi45.
Exemplo 5
Set-SPOApplication -OwningApplicationId 423poi45 -ItemMajorVersionLimit 1000
Este exemplo define o ItemMajorVersionLimit como 1000.
Parâmetros
-CopilotEmbeddedChatHosts
Esse parâmetro é usado para adicionar URLs de host com permissão para usar a experiência do agente declarativo do aplicativo incorporado do SharePoint. Sempre será um subconjunto de URLs permitidas definidas pelo desenvolvedor do aplicativo. Para marcar a lista de URLs permitidas, use o Get-SPOApplication cmdlet.
Propriedades do parâmetro
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ItemMajorVersionLimit
Esse parâmetro é usado para substituir ItemMajorVersionLimit para tipos de contêiner.
Propriedades do parâmetro
| Tipo: | Int |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OverrideTenantSharingCapability
Essa configuração permite que o aplicativo defina independentemente seus recursos de compartilhamento, substituindo as configurações de nível de locatário do SharePoint Online. Opções:
- Falso (padrão) – o aplicativo segue o recurso de compartilhamento no nível do locatário
- Verdadeiro - As configurações de compartilhamento do aplicativo são independentes da funcionalidade de compartilhamento no nível do locatário
Propriedades do parâmetro
| Tipo: | System.Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OwningApplicationId
Esse parâmetro especifica a ID do aplicativo Embedded do SharePoint.
Propriedades do parâmetro
| Tipo: | System.Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SharingCapability
Determina qual nível de compartilhamento está disponível para o aplicativo incorporado do SharePoint.
Os valores válidos são:
- ExternalUserAndGuestSharing (padrão): o compartilhamento de usuário externo (compartilhamento por email) e compartilhamento de link de convidado estão habilitados.
- Desabilitado: o compartilhamento de usuário externo (compartilhamento por email) e o compartilhamento de link de convidado estão desabilitados.
- ExternalUserSharingOnly: o compartilhamento de usuário externo (compartilhamento por email) está habilitado, mas o compartilhamento de link de convidado está desabilitado.
- ExistingExternalUserSharingOnly - somente os convidados que já estão no diretório da sua organização.
A configuração padrão é Nenhum, o que significa que o aplicativo segue as configurações de compartilhamento no nível do locatário do SharePoint Online. Use o Get-SPOTenant cmdlet para exibir essas configurações.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.TenantManagement.SharingCapabilities |
| Valor padrão: | None |
| Valores aceitos: | Disabled, ExternalUserSharingOnly, ExternalUserAndGuestSharing, ExistingExternalUserSharingOnly |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.