Addzoneurl: operação de Stsadm (Windows SharePoint Services)
Atualizado em: 2007-12-13
Nome da operação: Addzoneurl
Descrição
Configura e mapeia a URL pública para uma das cinco zonas de URL de um aplicativo Web ou recurso externo.
Essa propriedade equivale à configuração da interface do usuário URLs públicas localizada na página Editar URLs públicas de zona do Aplicativo Web do site da Administração Central do SharePoint.
Para obter mais informações, consulte Configurar o mapeamento alternativo de acesso (Windows SharePoint Services).
Sintaxe
stsadm -o addzoneurl
** -url <Nome da URL>**
** -urlzone {Default | Internet | Intranet | Extranet | Custom}**
** -zonemappedurl <http://url.pública>**
** -resourcename <nome do recurso de aplicativo não-Web>**
Parâmetros
Nome do parâmetro |
Valor |
Obrigatório? |
Descrição |
url |
Uma URL válida, como http://nome_do_servidor ou http://nome_do_servidor:1234 |
Não. Entretanto, se for usado o parâmetro url, o parâmetro resourcename não pode ser usado. |
URL do aplicativo Web. Esse parâmetro deve ser uma URL de mapeamentos de acesso alternativo (AAM) atribuída a um aplicativo Web para que Stsadm possa determinar que aplicativo Web você está direcionando. A URL pode ser uma URL pública ou interna de qualquer zona associada ao aplicativo Web direcionado. |
urlzone |
Um dos seguintes valores:
|
Sim |
Uma das cinco zonas às quais a URL pública está associada. |
zonemappedurl |
Uma URL válida, como https://www.contoso.com |
Sim |
A URL pública que você quer adicionar. Ela é usada como URL base usada em hiperlinks em páginas da Web ou emails que trafegam do servidor Web para o servidor proxy reverso ou para o cliente. Essa URL é aquela que pode ser acessada pelo usuário final. Esta etapa assegura que o usuário final veja a URL correta retornada do servidor para o cliente. |
resourcename |
Um nome válido, como "Resource1" |
Não. Entretanto, se for usado o parâmetro resourcename, o parâmetro url não pode ser usado. |
Deve ser criado um novo nome de recurso com uma URL pública em sua zona padrão, com o uso da operação addzoneurl. Criado o nome do recurso, você pode usar o nome do recurso existente para adicionar URLs públicas a zonas adicionais ou atualizar URLs públicas existentes. Esse parâmetro equivale à configuração da interface do usuário Mapeamento de Recurso Externo localizada na página Criar Mapeamento de Recurso Externo do site da Administração Central do SharePoint. |
Comentários
No Windows SharePoint Services 2.0, uma URL interna era referida como URL de entrada e uma URL pública, como URL de saída.
Para cada solicitação da Web, o Windows SharePoint Services 3.0 determina o protocolo, cabeçalho de host e a porta da solicitação e procura uma URL interna correspondente inserida anteriormente. Se for encontrada uma URL interna correspondente, o Windows SharePoint Services 3.0 determinará a zona a ser usada para formatar os hiperlinks na resposta. Uma zona de URL contém uma URL pública e uma ou mais URLs internas.
Os mapeamentos de acesso alternativo permitem que um aplicativo Web que receba uma solicitação de uma URL interna, em uma das cinco zonas de autenticação, retorne páginas que contenham links para a URL pública da zona. Você pode associar um aplicativo Web a um conjunto de mapeamentos entre URLs internas e públicas.
Interna refere-se à URL de uma solicitação da Web recebida pelo Windows SharePoint Services 3.0. Pública refere-se à URL de um site acessível externamente. A URL pública é a URL base que o Windows SharePoint Services 3.0 usa nas páginas que retorna.
Se a URL interna tiver sido modificada por um dispositivo proxy reverso, poderá diferir da URL pública.
Várias URLs internas podem ser associadas a uma única URL pública. Os conjuntos de mapeamentos podem conter até cinco zonas de autenticação, mas cada uma delas pode ter somente uma única URL pública. Os conjuntos de mapeamentos correspondem às seguintes zonas de autenticação:
Padrão
Internet
Intranet
Extranet
Personalizada
A zona Padrão deve sempre conter uma URL pública.
Para obter informações adicionais sobre zonas, URLs e arquitetura lógica, consulte Projetar a arquitetura lógica (Windows SharePoint Services)
Os conjuntos de sites com nome de host não podem usar mapeamentos de acesso alternativo. Eles são automaticamente considerados como integrantes da zona Padrão e a URL da solicitação não deve ser modificada entre o usuário final e o servidor.
Exemplos
Se um servidor proxy reverso ou balanceador de carga receber uma solicitação do usuário como https://www.contoso.com e a encaminhar ao servidor que executa o Windows SharePoint Services 3.0 como http://sharepoint.courses.contoso.com:1234, o administrador deverá configurar as seguintes URLs para um aplicativo Web do SharePoint:
URL interna: http://sharepoint.courses.contoso.com:1234
URL pública: https://www.contoso.com
Nesse exemplo, https://sharepoint:1234 já é uma URL AAM atribuída a um aplicativo Web e a zona da Internet é usada.
Para definir a URL pública de uma zona de URL, use a sintaxe a seguir:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com
Para confirmar a alteração para a URL pública, use a sintaxe a seguir:
stsadm -o enumalternatedomains -url https://sharepoint:1234
Consulte também
Conceitos
Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls