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>]
[[-ItemMajorVersionLimit] <Int>]
[[-EnableAutoExpirationVersionTrim] <Boolean>]
[[-ExpireVersionsAfterDays] <Int>]
[[-FileTypesForVersionExpiration] <String[]>]
[[-RemoveVersionExpirationFileTypeOverride] <String[]>]
[<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 -ItemMajorVersionLimit 1000
Este exemplo define o ItemMajorVersionLimit como 1000.
Exemplo 5
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $true
Este exemplo habilita a filtragem automática do histórico de versão para os contêineres do aplicativo. Quando o corte automático está habilitado ExpireVersionsAfterDays e ItemMajorVersionLimit são gerenciados automaticamente e não podem ser definidos ao mesmo tempo.
Exemplo 6
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $false -ItemMajorVersionLimit 500 -ExpireVersionsAfterDays 180
Este exemplo desabilita o corte automático e define uma política de versão manual. Quando EnableAutoExpirationVersionTrim é $false, ambos ItemMajorVersionLimit e ExpireVersionsAfterDays deve ser especificado.
Exemplo 7
Set-SPOApplication -OwningApplicationId 423poi45 -ExpireVersionsAfterDays 365 -FileTypesForVersionExpiration "docx","xlsx"
Este exemplo aplica a política de expiração de versão aos tipos de arquivo especificados.
Exemplo 8
Set-SPOApplication -OwningApplicationId 423poi45 -RemoveVersionExpirationFileTypeOverride "docx","xlsx"
Este exemplo remove as substituições de expiração de versão do tipo de arquivo para os tipos de arquivo especificados.
RemoveVersionExpirationFileTypeOverride Não pode ser combinado com nenhum outro parâmetro de política de versão.
Parâmetros
-EnableAutoExpirationVersionTrim
Habilita ou desabilita o corte automático do histórico de versão do arquivo para os contêineres do aplicativo incorporado do SharePoint.
-
$true- Os limites do histórico de versões são gerenciados automaticamente.ExpireVersionsAfterDayseItemMajorVersionLimitnão podem ser especificados ao mesmo tempo. -
$false- Uma política de versão manual é usada. AmbosItemMajorVersionLimiteExpireVersionsAfterDaysdevem ser especificados.
Propriedades do parâmetro
| Tipo: | System.Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExpireVersionsAfterDays
O número de dias após os quais as versões de arquivo expiram. Um valor de 0 significa que as versões nunca expiram. Caso contrário, o valor deve estar entre 30 e 36500. Este parâmetro não pode ser usado quando EnableAutoExpirationVersionTrim é $true.
Propriedades do parâmetro
| Tipo: | Int |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FileTypesForVersionExpiration
Os tipos de arquivo cuja política de expiração de versão deve ser atualizada. A matriz não pode estar vazia e pelo menos uma das EnableAutoExpirationVersionTrim, ItemMajorVersionLimit, ou ExpireVersionsAfterDays também deve ser especificada.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 7 |
| 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. Os valores válidos estão entre 1 e 50000.
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 |
-RemoveVersionExpirationFileTypeOverride
As substituições de expiração de versão do tipo de arquivo a serem removidas. A matriz não pode estar vazia. Esse parâmetro é exclusivo e não pode ser combinado com FileTypesForVersionExpiration, EnableAutoExpirationVersionTrim, ItemMajorVersionLimit, ou ExpireVersionsAfterDays.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 8 |
| Obrigatório: | False |
| 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.