Convert-SPWebApplication

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Converte o modo de autenticação de um aplicativo da Web.

Syntax

Convert-SPWebApplication
       -Identity <SPWebApplicationPipeBind>
       -From <String>
       -To <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Force]
       [-RetainPermissions]
       [-Database <SPContentDatabase>]
       [-MapList <String>]
       [-SiteSubsriptionId <Guid>]
       [-SkipPolicies]
       [-SkipSites]
       [-SourceSkipList <String>]
       [-TrustedProvider <SPTrustedIdentityTokenIssuerPipeBind>]
       [-LoggingDirectory <String>]
       [<CommonParameters>]

Description

Use o cmdlet Convert-SPWebApplication para converter o modo de autenticação de um Windows aplicativo Web em um modo de autenticação de declarações e migrar as contas de usuário no banco de dados de conteúdo para valores codificados por declarações.

Ao reter permissões, os usuários em Sites só serão convertidos se a conta de origem estiver habilitada e consultada por SharePoint. Por exemplo, se a conta do Active Directory for excluída ou desabilitada antes de uma conversão de declarações de Windows clássica para Windows, a conta no banco de dados não será atualizada para o formato Declarações.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

------------EXEMPLO 1----------------

Convert-SPWebApplication -Identity "https://<webappurl>" -To Claims -RetainPermissions

Este exemplo converte um aplicativo da Web especificado pelo parâmetro Identity para usar o modo de autenticação de declaração.

------------EXEMPLO 2-------

Convert-SPWebApplication -Identity "https://<webappurl>" -From Legacy -To Claims -RetainPermissions

Este exemplo converte um aplicativo Web especificado pelo parâmetro Identity Windows autenticação clássica para o modo de autenticação de declarações enquanto mantém permissões. O parâmetro -From é necessário após a atualização de segurança MS04-022 ou a Atualização Cumulativa de abril de 2014 para o SharePoint Server 2013 ser aplicada. Isso é necessário para todas as versões do SharePoint Server 2016.

Parâmetros

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Database

Especifica o nome do banco de dados de conteúdo a ser migrado.

Type:	SPContentDatabase
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Força

Força a conversão de um aplicativo Web.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-From

Especifica o método de autenticação a ser convertido.

Os valores válidos para esse parâmetro são os seguinte.

Legacy, Claims-Windows, Claims-Trusted-Default

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identidade

Especifica o URL do aplicativo Web que você deseja converter, por exemplo: https://mysite/app1

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-LoggingDirectory

Especifica um diretório em que logs detalhados sobre os resultados da migração serão gravados.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2016, SharePoint Server 2019

-MapList

Especifica um arquivo que contém como lista de linhas no seguinte formato: user-key, migrated-user-name, migrated-user-key.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RetainPermissions

Especifica a conta na qual cada cmdlet está sendo executado e retém as permissões no aplicativo Web.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteSubsriptionId

Especifica o GUID para a Assinatura do Site.

Type:	Guid
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SkipPolicies

Especifica que as políticas de segurança SPWebApplication não serão migradas.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SkipSites

Especifica que os SPSites do SPWebApplication não serão migrados.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceSkipList

Especifica um arquivo que contém como lista de linhas no seguinte formato: user-key.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-To

Especifica o método de autenticação a ser convertido.

Os valores válidos para esse parâmetro são os seguinte.

Declarações, declarações-Windows, declarações-trusted-default, claims-SharePoint-online

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TrustedProvider

Ao migrar de um provedor de logon confiável, é assim que você especifica qual provedor de logon confiável.

Type:	SPTrustedIdentityTokenIssuerPipeBind
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019