Set-SPWebApplication
Configura o aplicativo Web especificado.
Syntax
Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
[-DefaultTimeZone <Int32>]
[-DefaultQuotaTemplate <String>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AuthenticationMethod <String>]
[-Force]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
-Port <Int32>
[-Url <String>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-SMTPServer <String>
[-SMTPServerPort <Int32>]
[-OutgoingEmailAddress <String>]
[-ReplyToEmailAddress <String>]
[-SMTPCredentials <PSCredential>]
[-DisableSMTPEncryption]
[-Certificate <SPServerCertificatePipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.
O Set-SPWebApplication cmdlet configura o aplicativo Web especificado pelo parâmetro Identity.
Para as configurações específicas de zona (para o conjunto de parâmetros Zone), forneça a zona a ser configurada.
A zona fornecida deve ser existente.
Todas as configurações de associação do IIS devem ser respecificadas ao atualizar a associação de um site do IIS por meio do Set-SPWebApplication cmdlet. Isso inclui a URL, a configuração da camada de soquetes seguros, o número da porta, o cabeçalho do host e o certificado. Se uma configuração de associação não for respecificada, ela será revertida para seu valor padrão.
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
$credentials = Get-Credential
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -SMTPServerPort 587 -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $credentialsEste exemplo define o http://servername aplicativo Web para usar o servidor SMTP mail.example.com, a porta do servidor SMTP 587, o do endereço user@example.com, o endereço replyto@example.comde resposta a e as credenciais armazenadas no objeto $credentials.
EXEMPLO 2
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $nullEste exemplo define o http://servername aplicativo Web para usar o servidor SMTP mail.example.com, a porta de servidor SMTP padrão, o do endereço user@example.com, o endereço replyto@example.comde resposta a e para se conectar ao servidor SMTP anonimamente.
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 |
-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 |
-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
Use para definir um aplicativo Web como autenticação do Windows clássico. Os valores válidos são NTLM ou Kerberos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationProvider
Define os provedores de autenticação que se aplicam ao 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 ou para autenticação em um servidor SMTP para enviar email.
Ao configurar a associação SSL (Secure Sockets Layer) deste site do IIS, esse parâmetro só é válido quando usado com o parâmetro SecureSocketsLayer. Ao configurar a autenticação SMTP, esse parâmetro só é válido quando o parâmetro DisableSMTPEncryption não é especificado.
| 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 |
-DefaultQuotaTemplate
Especifica o novo modelo de cota de site padrão para este 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 |
-DefaultTimeZone
Especifica o fuso horário padrão para novas coleções de sites neste aplicativo Web.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DisableSMTPEncryption
Especifica se a Criptografia SMTP deve ser ativada ou desativada.
O valor padrão é falso.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
Suprime as mensagens de confirmação envolvidas nas configurações de um aplicativo Web.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 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 |
-Identity
Especifica o nome ou a URL do aplicativo Web.
O tipo deve ser um nome válido, no formato WebApplication-1212, ou uma URL, no formato https://example.contoso.com.
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NotProvisionGlobally
Provisiona apenas o aplicativo Web no servidor local com as alterações especificadas por este cmdlet. Os aplicativos Web em outros servidores no farm não serão provisionados com essas alterações.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-OutgoingEmailAddress
Especifica o novo endereço de email de saída para mensagens de email enviadas deste aplicativo Web. O tipo deve ser um endereço válido; por exemplo, someone@example.com.
| 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 esse aplicativo Web pode ser acessado. Pode ser qualquer número de porta válido.
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: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ReplyToEmailAddress
Configura o endereço de email de resposta.
O tipo deve ser um endereço válido; por exemplo, someone@example.com.
| Type: | String |
| 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 SSL (Secure Sockets Layer) para este 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 proxy de aplicativo de serviço personalizado para o aplicativo Web a ser usado. O aplicativo Web usará os proxies neste grupo de proxy para se conectar a aplicativos de serviço. Se esse parâmetro não for especificado, o grupo de proxy padrão do 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 |
-SMTPCredentials
Especifica credenciais para autenticação no servidor SMTP. Defina o valor como $null para se conectar ao servidor SMTP anonimamente. Se esse parâmetro não for especificado, as configurações de autenticação existentes serão preservadas.
Você deve usar o cmdlet do Set-SPApplicationCredentialKey PowerShell para definir uma chave de credencial de aplicativo idêntica em cada servidor no farm antes de especificar credenciais.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServer
Especifica o novo servidor SMTP de saída que este aplicativo Web usará. Defina como $null para limpar a configuração do servidor.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServerPort
Especifica um valor de porta SMTP.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Url
Especifica a URL balanceada de carga para a zona do 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 |
-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 SSL.
| 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 |
-Zone
Ao configurar configurações específicas da zona, a zona a ser configurada deve ser especificada. Essa zona já deve existir.
O tipo deve ser um dos valores a seguir: Default, Intranet, Internet, Extranet ou Custom.
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |