New-SPWebApplicationExtension
Cria uma nova instância de zona para o aplicativo Web.
Syntax
New-SPWebApplicationExtension
[-Identity] <SPWebApplicationPipeBind>
-Name <String>
-Zone <SPUrlZone>
[-Port <UInt32>]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AllowAnonymousAccess]
[-SecureSocketsLayer]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O New-SPWebApplicationExtension cmdlet cria uma nova instância de zona para o aplicativo Web.
Esse procedimento também é conhecido como expandir um aplicativo Web e permite que permissões alternativas sejam configuradas para o mesmo conteúdo disponível no aplicativo Web existente.
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-----------------------
Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"Este exemplo estende o aplicativo Web determinado na http://sitename zona Extranet para uso de SSL.
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 à zona do 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 |
-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.
| 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(s) provedor(es) de autenticação aplicável(is) 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 |
-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 |
-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 aplicativo Web que será expandido.
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
Especifica o nome do novo site do IIS no aplicativo Web.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
Especifica o diretório físico do novo site (na pasta diretórios virtuais). O tipo é um caminho válido, no formato C:\Inetpub\wwwroot\MyWebApplication.
| 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 do aplicativo. Pode ser qualquer número de porta válido.
Se nenhuma porta for especificada, um número de porta não conflitante será gerado automaticamente.
Caso o número da porta especificado já tenha sido atribuído, o IIS não iniciará o novo site até que o número da porta do novo site ou o número da porta do site antigo seja alterado.
| 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 |
-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 referente à 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 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 |
-Zone
Especifica uma das cinco zonas à qual a URL interna da nova extensão deverá ser associada. Essa zona ainda não pode estar em uso.
O tipo deve ser qualquer um dos seguintes valores: Padrão, Intranet, Internet, Extranet ou Personalizado
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |