New-SPWebApplication

Referência

Módulo:: SharePointServer

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

Cria um novo aplicativo da Web dentro do farm local.

Syntax

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 um novo aplicativo Web usando um header de host interno de sharepoint.contoso.com e uma URL pública 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 um novo aplicativo Web habilitado para SSL usando um header de host interno de sharepoint.contoso.com e uma URL pública 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 um Windows Web de declarações na URL usando o domínio da conta https://www.contoso.com de domínio\wa.

Parâmetros

-AdditionalClaimProvider

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

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

-AllowAnonymousAccess

Permite o acesso anônimo ao aplicativo Web.

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

-ApplicationPool

Especifica o nome de um pool de aplicativos a ser usado; 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.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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. Use o Get-SPIisWebServicApplicationPool cmdlet para usar uma conta do sistema.

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

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

-Confirm

Solicita a sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	PSCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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. Caso nenhum valor seja especificado, será gerado automaticamente um valor no formato WSS_Content_<GUID>.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 estiver presente, o valor desse campo será a URL interna do aplicativo Web. O parâmetro Url é usado para especificar a URL pública. Se nenhum valor for especificado, o valor será deixado em branco.

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

-Name

Especifica o nome do novo aplicativo Web.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	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 nenhum valor for especificado, o valor %wwwroot%\wss\VirtualDirectories \ <portnumber> será aplicado.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	UInt32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	SPServiceApplicationProxyGroupPipeBind
Aliases:	ProxyGroup
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

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

-SignInRedirectURL

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

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

-URL

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

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

-UserSettingsProvider

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

Type:	SPUserSettingsProviderPipeBind
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

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