New-SPWebApplication
Cria um novo aplicativo da Web dentro do farm local.
Syntax
New-SPWebApplication
-Name <String>
-ApplicationPool <String>
[-ApplicationPoolAccount <SPProcessAccountPipeBind>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Port <UInt32>]
[-AllowAnonymousAccess]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseServer <String>]
[-DatabaseName <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<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 cabeçalho 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 cabeçalho 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 aplicativo Web de Declarações do Windows na URL https://www.contoso.com usando o domínio da conta de domínio\wa.
Parâmetros
-AdditionalClaimProvider
Adiciona um provedor de declaração específico ao aplicativo Web definido.
Type: | SPClaimProviderPipeBind[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-AllowAnonymousAccess
Permite acesso anônimo ao aplicativo Web.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-AllowLegacyEncryption
Especifica que versões de protocolo SSL e TLS mais antigas e pacotes de criptografia podem ser usados com este site do IIS. A criptografia herdada é mais fraca que a criptografia moderna e não é recomendada.
Esse recurso requer o Windows Server 2022 ou superior. Esse recurso não está disponível quando o SharePoint é implantado com versões anteriores do Windows Server.
Esse parâmetro só é válido quando usado com o parâmetro SecureSocketsLayer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-AuthenticationProvider
Especifica o provedor ou provedores de autenticação que se aplicam a um aplicativo Web.
Type: | SPAuthenticationProviderPipeBind[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Certificate
Especifica o certificado que será usado para a associação SSL (Secure Sockets Layer) deste site do IIS. Esse parâmetro só é válido quando usado com o parâmetro SecureSocketsLayer.
Type: | SPServerCertificatePipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Confirm
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 nenhum valor for especificado, um valor no formato WSS_Content_<GUID> será gerado automaticamente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-HostHeader
Especifica a associação de cabeçalho do host para este site do IIS. Uma associação de cabeçalho de host permite que vários sites do IIS compartilhem o mesmo número de porta. As solicitações da Web enviadas para um número de porta compartilhada são roteada para o site correto do IIS com base no valor do cabeçalho de host HTTP enviado pelo cliente.
Se nenhuma associação de cabeçalho de host for especificada, todas as solicitações da Web enviadas para esse número de porta serão roteadas para este site do IIS, a menos que outro site do IIS tenha uma associação de cabeçalho de host que corresponda ao cabeçalho de host HTTP enviado pelo cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Name
Especifica o nome do novo aplicativo Web.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Path
Especifica o diretório físico do novo aplicativo Web na pasta 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-SecureSocketsLayer
Habilita a criptografia de protocolo SSL para o aplicativo Web. Se você optar por usar o SSL, deverá importar um certificado de servidor para o SharePoint e atribuí-lo ao site do IIS para este aplicativo Web. Até que isso seja feito, o aplicativo Web ficará inacessível neste site do IIS.
O valor padrão é False.
Se esse parâmetro for omitido ou definido como False, esse aplicativo Web usará HTTP para a porta especificada.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-SignInRedirectURL
Especifica a URL de redirecionamento de entrada para o aplicativo Web.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Url
Especifica a URL com balanceamento de carga para o aplicativo Web.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-UserSettingsProvider
Fornece acesso às configurações do provedor do usuário externo.
Type: | SPUserSettingsProviderPipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-UseServerNameIndication
Especifica que a associação SSL (Secure Sockets Layer) deste site do IIS deve usar a Indicação de Nome do Servidor (SNI). A Indicação de Nome do Servidor permite que vários sites do IIS com cabeçalhos de host exclusivos e certificados de servidor exclusivos compartilhem a mesma porta SSL. Se a Indicação de Nome do Servidor não for usada, todos os sites do IIS que compartilham a mesma porta SSL deverão compartilhar o mesmo certificado de servidor.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |