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. ExpireVersionsAfterDays e ItemMajorVersionLimit não podem ser especificados ao mesmo tempo.
  • $false - Uma política de versão manual é usada. Ambos ItemMajorVersionLimit e ExpireVersionsAfterDays devem 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.

Entradas

None

Saídas

System.Object