New-SPAlternateURL
Cria uma nova URL pública ou interna para o recurso ou a zona do aplicativo Web especificado.
Sintaxe
WebApplication
New-SPAlternateURL
[-Url] <String>
-WebApplication <SPWebApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Internal]
[-WhatIf]
[-Zone <SPUrlZone>]
[<CommonParameters>]
ResourceName
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 pedidos de entrada para https://www.contoso.com ( https://sharepoint.contoso.com 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
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Internal
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Transforma essa URL alternativa em uma URL interna. Se esse parâmetro não for fornecido, a URL será uma URL pública.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResourceName
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ResourceName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Url
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica a URL pública que os usuários acessam para entrar no aplicativo Web.
O tipo tem de ser um URL válido, no formulário https://server_name.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WebApplication
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPWebApplicationPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
WebApplication
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Zone
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriedades do parâmetro
| Tipo: | SPUrlZone |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.