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>]

Pode utilizar este cmdlet para configurar ou desativar a funcionalidade de pré-autenticação no SharePoint Online. A desativação pode ser combinada com comutadores para suportar a gestão de pré-autenticação granular para aplicações e funcionalidades específicas ao nível do inquilino.

Tem de 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 desativa a pré-autenticação em geral e adiciona uma definição que permite que duas aplicações utilizem a pré-autenticação para todas as funcionalidades.

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 neste caso os comutadores para -ExcludedApps, -IncludedFeaturese -ExcludedFeatures são adicionados ao cmdlet .

Presume-se que estes parâmetros assumem o valor predefinido de "" se não forem utilizados com o cmdlet e o exemplo 2 é utilizado para demonstrar apenas o conjunto completo de comutadores.

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

Este exemplo irá remover um item existente da lista atual de itens. O comutador remover pode remover entradas de permissão ou negação da lista.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Este exemplo desativa a pré-autenticação geral e permite que todas as aplicações para além de uma utilizem a pré-autenticação para todas as funcionalidades, exceto para "Download" e "WebRenderingEmbed".

Neste caso, a aplicação "029e7c27-4b9c-4f8b-ba32-b96249468d42" será sempre impedida de utilizar a pré-autenticação, uma vez que está excluída da definição da lista de permissões. Qualquer outra aplicação terá permissão para utilizar a pré-autenticação para qualquer funcionalidade para 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 desativa a pré-autenticação geral, mas contém uma sobreposição entre as definições na lista Permitir e Negar. Primeiro, permite que uma aplicação utilize a pré-autenticação para as "OfficeOnline"funcionalidades , "WebRenderingEmbed"e "Download" . No entanto, na execução final do cmdlet, nega que a mesma aplicação utilize a pré-autenticação para todas as funcionalidades.

Neste caso, a aplicação "029e7c27-4b9c-4f8b-ba32-b96249468d42" não teria permissão para utilizar a pré-autenticação para qualquer uma das funcionalidades listadas, apesar de ter a definição . Isto deve-se ao facto de a lista Negar ter 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 pedidos que não são provenientes de uma aplicação (por exemplo, pedidos provenientes de um browser) de utilizar a pré-autenticação para todas as funcionalidades.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

-ExcludedFeatures E -IncludedFeatures utilize os nomes das funcionalidades da tabela seguinte. Menciona explicitamente se a funcionalidade será quebrada se estiver desativada através do cmdlet do PowerShell.