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