Compartilhar via

Convert-SPWebApplication

Módulo:
SharePointServer module

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

Sintaxe

Default (Padrão) 

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

Utilize o cmdlet Convert-SPWebApplication para converter o modo de autenticação de uma aplicação Web para o modo de autenticação de Afirmações do Windows e migrar as contas de utilizador na base de dados de conteúdos para afirmações de valores codificados.

Ao manter as permissões, os utilizadores nos Sites só são convertidos se a conta de origem estiver ativada e consultada pelo SharePoint. Por exemplo, se a conta do Active Directory for eliminada ou desativada antes de uma conversão clássica do Windows para Afirmações do Windows, a conta na base de dados não será atualizada para o formato Afirmaçõ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 uma aplicação Web especificada pelo parâmetro Identidade do autenticação do Windows Clássico para o modo de autenticação afirmações ao manter as 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. Isto é 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 da base de dados de conteúdos a migrar.

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 a partir do qual converter.

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

Legado, 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 onde serão escritos registos verbosos sobre os resultados da migração.

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 ficheiro 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 da Subscrição 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 de 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 ficheiro que contém como lista de linhas no seguinte formato: chave de utilizador.

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.

Afirmações, 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

Ao migrar a partir de um fornecedor de início de sessão fidedigno, é desta forma que especifica o fornecedor de início de sessão fidedigno.

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