Set-SPOTenantPreAuthSettings

Set-SPOTenantPreAuthSettings
    -IsDisabled <Boolean>
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Type <TenantPreAuthSettingsListType>
    [-Add]
    [-IncludedApps <String>]
    [-ExcludedApps <String>]
    [-IncludedFeatures <String>]
    [-ExcludedFeatures <String>]
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Id <String>
    [-Remove]
    [<CommonParameters>]

Você pode usar esse cmdlet para configurar ou desabilitar o recurso de pré-autenticação no SharePoint Online. A desabilitação pode ser combinada com comutadores para dar suporte ao gerenciamento granular de pré-autenticação para aplicativos e recursos específicos no nível do locatário.

Você deve ser um administrador do SharePoint para executar o cmdlet.

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

Este exemplo desabilita a pré-autenticação geral e adiciona uma configuração que permite que dois aplicativos usem a pré-autenticação para todos os recursos.

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e" -ExcludedApps "" -IncludedFeatures "" -ExcludedFeatures ""

Este exemplo executa a mesma função que o exemplo 1, exceto que, nesse caso, as opções para -ExcludedApps, -IncludedFeaturese -ExcludedFeatures são adicionadas ao cmdlet.

Supõe-se que essas opções tenham o valor padrão de "" se não forem usadas com o cmdlet, e o exemplo 2 é usado para demonstrar apenas o conjunto completo de opções.

Set-SPOTenantPreAuthSettings -Remove -Id "368dde6f-c857-4383-a8a7-02a04a294e6d"

Este exemplo removerá um item existente da lista atual de itens. A opção de remoção pode remover entradas permitidas ou negadas da lista.

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -ExcludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -ExcludedFeatures "Download,WebRenderingEmbed"

Este exemplo desabilita a pré-autenticação geral e permite que todos os aplicativos, exceto um, usem a pré-autenticação para todos os recursos, exceto para "Download" e "WebRenderingEmbed".

Nesse caso, o aplicativo sempre terá o uso "029e7c27-4b9c-4f8b-ba32-b96249468d42" da pré-autenticação, pois ele é excluído da configuração da lista de permissões. Qualquer outro aplicativo terá permissão para usar a pré-autenticação para qualquer recurso além de "Download" e "WebRenderingEmbed".

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -IncludedFeatures "OfficeOnline,WebRenderingEmbed,Download"

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

Este exemplo desabilita a pré-autenticação geral, mas contém uma sobreposição entre as configurações na lista de permissões e na lista de negações. Primeiro, ele permite que um aplicativo use a pré-autenticação para os "OfficeOnline"recursos , "WebRenderingEmbed", e "Download" . Mas na execução final do cmdlet, ele nega que o mesmo aplicativo use a pré-autenticação para todos os recursos.

Nesse caso, o aplicativo "029e7c27-4b9c-4f8b-ba32-b96249468d42" não teria permissão para usar a pré-autenticação para nenhum dos recursos da lista de permissões, apesar de ter a configuração. Isso ocorre porque a lista Negar tem precedência sobre a lista Permitir.

Set-SPOTenantPreAuthSettings -IsDisabled $false

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "Empty"

Este exemplo permite a pré-autenticação geral e nega que solicitações que não sejam provenientes de um aplicativo (por exemplo, solicitações provenientes por meio de um navegador) usem a pré-autenticação para todos os recursos.

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.

O -IncludedFeatures e -ExcludedFeatures use nomes de recursos da tabela a seguir. Ele menciona explicitamente se o recurso será interrompido se for desabilitado por meio do cmdlet do PowerShell.