Compartilhar via


New-SPWebApplication

Cria um novo aplicativo da Web dentro do farm local.

Sintaxe

New-SPWebApplication
   -ApplicationPool <String>
   -Name <String>
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-AllowAnonymousAccess]
   [-ApplicationPoolAccount <SPProcessAccountPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMethod <String>]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-Confirm]
   [-DatabaseCredentials <PSCredential>]
   [-DatabaseName <String>]
   [-DatabaseServer <String>]
   [-HostHeader <String>]
   [-Path <String>]
   [-Port <UInt32>]
   [-SecureSocketsLayer]
   [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-SignInRedirectURL <String>]
   [-Url <String>]
   [-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Cria um novo aplicativo Web especificado pelo parâmetro Name. O usuário especificado pelo parâmetro DatabaseCredentials deve ser membro da função de servidor fixa dbcreator no servidor de banco de dados.

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

New-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "http://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

Este exemplo cria uma nova aplicação Web com um cabeçalho de anfitrião interno de sharepoint.contoso.com e um URL público de http://www.contoso.com.

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

New-SPWebApplication -Name "Contoso Internet Site" -Port 443 -SecureSocketsLayer -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com:443" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

Este exemplo cria uma nova aplicação Web ativada por SSL com um cabeçalho de anfitrião interno de sharepoint.contoso.com e um URL público de https://www.contoso.com.

------------------EXEMPLO 3-----------------------

$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com"  -Port 443 
-ApplicationPool "ContosoAppPool" 
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa") 
-AuthenticationProvider $ap -SecureSocketsLayer

Cria uma aplicação Web Afirmações do Windows no URL https://www.contoso.com com o domínio da conta de domínio\wa.

Parâmetros

-AdditionalClaimProvider

Adiciona um provedor de declarações ao aplicativo Web definido.

Tipo:SPClaimProviderPipeBind[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AllowAnonymousAccess

Permite o acesso anônimo ao aplicativo Web.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ApplicationPool

Especifica o nome de um conjunto aplicacional a utilizar; por exemplo, SharePoint - 1213. Se um pool de aplicativos com o nome fornecido não existir, o parâmetro ApplicationPoolAccount deverá ser fornecido e um novo pool de aplicativos será criado. Se nenhum valor for especificado, o pool de aplicativos padrão será usado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ApplicationPoolAccount

Especifica a conta de usuário em nome da qual o pool de aplicativos será executado. Utilize o Get-SPIisWebServicApplicationPool cmdlet para utilizar uma conta de sistema.

Tipo:SPProcessAccountPipeBind
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Tipo:SPAssignmentCollection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AuthenticationMethod

Usa Kerberos ou NTLM para especificar o método de autenticação. Caso nenhum valor seja especificado, o NTLM padrão será aplicado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AuthenticationProvider

Especifica o provedor ou provedores de autenticação que se aplicam a um aplicativo Web.

Tipo:SPAuthenticationProviderPipeBind[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseCredentials

Especifica o objeto Credential do Windows PowerShell para a conta de usuário do banco de dados.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

Especifica o nome do banco de dados de conteúdo inicial para o novo aplicativo Web.

O tipo deve ser um nome de banco de dados válido; por exemplo ContentDB1. Se não for especificado nenhum valor, será gerado automaticamente um valor no formato WSS_Content_<GUID> .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Especifica o nome do servidor de banco de dados. O tipo deve ser um nome de servidor de banco de dados válido, no formato SQL1; quando forem usadas instâncias nomeadas, o formato poderá ser servidor\servidor. A instância de servidor SQL padrão será usada se um valor não for fornecido.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HostHeader

Especifica uma URL válida atribuída ao aplicativo Web que deve ser correlacionado à configuração de mapeamento alternativo de acesso, no formato nome_do_servidor.

Quando o parâmetro HostHeader está presente, o valor deste campo é a URL interna do aplicativo Web. O parâmetro url é utilizado para especificar o URL público. Se não for especificado nenhum valor, o valor é deixado em branco.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

Especifica o nome do novo aplicativo Web.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Path

Especifica o diretório físico do novo aplicativo Web na pasta de diretórios virtuais. O tipo é um caminho válido, no formato C:\Inetpub\wwwroot\MyWebApplication. Se não for especificado nenhum valor, será aplicado o valor %wwwroot%\wss\VirtualDirectories\<portnumber> .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Port

Especifica a porta na qual este aplicativo Web pode ser acessado. Pode ser qualquer número de porta válido. Caso nenhuma porta seja especificada, um número de porta não conflitante será gerado automaticamente.

Se você especificar um número de porta que já foi atribuído, o IIS não iniciará o novo site até que você altere o número da porta do novo site ou o número da porta do site antigo.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SecureSocketsLayer

Habilita a criptografia de protocolo SSL para o aplicativo Web. Se você optar por usar SSL, adicione o certificado em cada servidor usando as ferramentas de administração do IIS. Até que isso seja feito, o aplicativo Web ficará inacessível pelo site do IIS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ServiceApplicationProxyGroup

Especifica um grupo de proxies de aplicativo de serviço para ser usado pelo aplicativo Web. O aplicativo Web usará os proxies desse grupo de proxies para se conectar a aplicativos de serviço. Se esse parâmetro não for especificado, o grupo de proxies padrão para o farm será usado.

Tipo:SPServiceApplicationProxyGroupPipeBind
Aliases:ProxyGroup
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SignInRedirectProvider

Define a URL de redirecionamento de entrada para apontar para a URL definida no provedor de autenticação especificado.

Tipo:SPTrustedIdentityTokenIssuerPipeBind
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SignInRedirectURL

Especifica a URL de redirecionamento de entrada para o aplicativo Web.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Url

Especifica a URL com balanceamento de carga para o aplicativo Web.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UserSettingsProvider

Fornece acesso às configurações do provedor do usuário externo.

Tipo:SPUserSettingsProviderPipeBind
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019