Compartilhar via


New-SPAlternateURL

Cria uma nova URL pública ou interna para o recurso ou a zona do aplicativo Web especificado.

Syntax

New-SPAlternateURL
   [-Url] <String>
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]
New-SPAlternateURL
   [-Url] <String>
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<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 cmdlet New-SPAlternateUrl cria uma nova URL pública ou interna para o recurso ou a zona do aplicativo Web especificado. Use o parâmetro ResourceName se a URL alternativa for para um recurso externo.

Cada aplicativo Web pode ser associado a um conjunto de mapeamentos entre URLs internas e públicas. As URLs internas e públicas consistem na parte de protocolo e de domínio da URL completa por exemplo, https://www.fabrikam.com. Os usuários digitam uma URL pública para chegarem ao site do SharePoint e essa URL será exibida nos links das páginas. As URLs internas estão em solicitações de URL enviadas ao site do SharePoint. Muitas URLs internas podem ser associadas a uma única URL pública em farms de vários servidores por exemplo, quando um balanceador de carga roteia solicitações de endereços IP específicos para vários servidores do cluster de balanceamento de carga.

Cada aplicativo Web dá suporte a cinco coleções de mapeamentos por URL; essas cinco coleções correspondem a cinco zonas (padrão, intranet, extranet, Internet e personalizada). Quando o aplicativo Web recebe uma solicitação por uma URL interna em uma zona específica, os links nas páginas retornadas ao usuário tem a URL pública referente a essa zona.

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

#create the public URL
New-SPAlternateURL https://www.contoso.com -Zone "Internet"

#create the internal URL
New-SPAlternateURL https://sharepoint.contoso.com -Zone "Internet" -internal

Este exemplo traduz as solicitações de entrada para https://www.contoso.comhttps://sharepoint.contoso.com em (na zona da Internet).

Quando um proxy reverso estiver sendo configurado para tratar da terminação SSL da URL pública, mapeamentos de acesso alternativo deverão ser configurados para tratar da conversão da URL.

Parâmetros

-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. 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to: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

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

-Internal

Transforma essa URL alternativa em uma URL interna. Se esse parâmetro não for fornecido, a URL será uma URL pública.

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

-ResourceName

Especifica o nome do recurso se a URL alternativa for para um recurso externo. Se nenhum valor for especificado, o valor será deixado em branco.

Type:String
Position:Named
Default value:None
Required:True
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 pública que os usuários acessam para entrar no aplicativo Web.

O tipo deve ser uma URL válida, no formulário https://server_name.

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

-WebApplication

Especifica o nome, a URL ou o GUID do aplicativo Web para o qual o mapeamento será criado.

O tipo precisa ser um nome válido, uma URL, no formato WebApplication-1212, https://server_name ou GUID no formato 1234-5678-9876-0987.

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
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 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Zone

Especifica uma das cinco zonas com as quais a URL alternativa é associada.

O tipo deve ser uma zona válida: Default, Intranet, Internet, Extranet ou Custom

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