Convert-SPWebApplication

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Converte o modo de autenticação de um aplicativo 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 aplicativo Web no modo de autenticação do Windows Claims e migrar as contas de usuário no banco de dados de conteúdo para declarações de valores codificados.

Ao reter permissões, os usuários em Sites só serão convertidos se a conta de origem estiver habilitada e consultada pelo SharePoint. Por exemplo, se a conta do Active Directory for excluída ou desabilitada antes de uma conversão clássica do Windows para Declarações do 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 de Classic autenticação do Windows para o modo de autenticação de Declarações, mantendo 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 SharePoint Server 2013 for aplicada. Isso é necessário para todas as versões do SharePoint Server 2016.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. 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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Database

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

Type:	SPContentDatabase
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-From

Especifica o método de autenticação do qual converter.

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

Herdado, Claims-Windows, Claims-Trusted-Default

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

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

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-LoggingDirectory

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SiteSubsriptionId

Especifica o GUID para a Assinatura do Site.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SkipPolicies

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SkipSites

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SourceSkipList

Especifica um arquivo que contém como lista de linhas no seguinte formato: chave de usuário.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-To

Especifica o método de autenticação para o qual converter.