Convert-SPWebApplication

Módulo:
SharePointServer module

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

Sintaxe

Default (Default) 

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 para o modo de autenticação de declarações do Windows e migrar as contas de usuário no banco de dados de conteúdo para declarações codificadas

Ao manter as permissões, os usuários em Sites só são convertidos se a conta de origem estiver habilitada e consultável pelo SharePoint. Por exemplo, se a conta do Active Directory for excluída ou desabilitada antes de uma conversão de declarações clássicas do Windows para o Windows, a conta no banco de dados não será atualizada para o formato de 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 da autenticação do Windows Clássica para o modo de autenticação de Declarações, mantendo permissões. O parâmetro -From é necessário após a aplicação da atualização de segurança MS04-022 ou da Atualização Cumulativa de abril de 2014 do SharePoint Server 2013. Isso é necessário para todas as versões do SharePoint Server 2016.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Database

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SPContentDatabase
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-From

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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

herdado, claims-windows, claims-trusted-default

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SPWebApplicationPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LoggingDirectory

Aplicável: SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MapList

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RetainPermissions

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SiteSubsriptionId

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o GUID para a Assinatura do Site.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipPolicies

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipSites

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SourceSkipList

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-To

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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

Claims, Claims-Windows, Claims-Trusted-Default, Claims-SharePoint-Online

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TrustedProvider

Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SPTrustedIdentityTokenIssuerPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
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.