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