Addzoneurl: operação do Stsadm (Office SharePoint Server)
Atualizado em: 2007-12-13
Descrição
Configura a URL pública e a mapeia 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 da Zona Pública do Aplicativo Web do site Administração Central do SharePoint.
Para obter mais informações, consulte Configurar mapeamento de acesso alternativo.
Sintaxe
stsadm -o addzoneurl
** -url <nome da URL>**
** -urlzone {Padrão | Internet | Intranet | Extranet | Personalizada}**
** -zonemappedurl <http://public.url>**
** -resourcename <nome do recurso do 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. No entanto, se o parâmetro url for usado, o parâmetro resourcename não poderá ser usado. |
URL do aplicativo Web. Esse parâmetro deve ser uma URL de AAM (mapeamentos de acesso alternativo) existente que esteja atribuída a um aplicativo Web, para que o Stsadm possa determinar para qual aplicativo Web você está direcionando. A URL pode ser pública ou interna de qualquer zona associada ao aplicativo Web de destino. |
urlzone |
Qualquer 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ê deseja adicionar. Ela é usada como a URL base usada nos hiperlinks em páginas da Web ou emails do servidor Web para o servidor proxy reverso ou o cliente. Essa URL é aquela que pode ser acessada pelo usuário final. Esta etapa garante que o usuário final veja a URL correta quando ela é retornada do servidor para o cliente. |
resourcename |
Um nome válido, como "Recurso1" |
Não. Porém, se o parâmetro resourcename for usado, o parâmetro url não poderá ser usado. |
É necessário criar um novo nome de recurso com uma URL pública em sua zona padrão, com o uso da operação addzoneurl. Depois da criação do nome do recurso, você poderá usar o nome de recurso existente para adicionar URLs públicas a zonas adicionais ou para atualizar as 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 Administração Central do SharePoint. |
Comentários
No Windows SharePoint Services 2.0, uma URL interna foi referenciada como uma URL de entrada e uma URL pública foi referenciada como uma URL de saída.
Para cada solicitação da Web, o Windows SharePoint Services 3.0 determina o protocolo, o cabeçalho do host e a porta da solicitação, e procura uma URL interna correspondente que tenha sido inserida anteriormente. Se uma URL interna correspondente for encontrada, o Windows SharePoint Services 3.0 então determina qual zona 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 recebe uma solicitação para 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, como ela é recebida pelo Microsoft Office SharePoint Server 2007. Pública refere-se à URL de um site acessível externamente. A URL pública é a URL base que o Office SharePoint Server 2007 usa nas páginas que ele retorna.
Se a URL interna tiver sido modificada por um dispositivo de proxy reverso, ela poderá ser diferente 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 zona só pode ter uma URL pública. Os conjuntos de mapeamentos correspondem às seguintes zonas de autenticação:
Padrão
Internet
Intranet
Extranet
Personalizada
A zona Padrão sempre deve conter uma URL pública.
Para obter informações adicionais sobre zonas e URLs, e para exibir um cenário de implantação corporativo de cada zona, consulte Modelo de arquitetura lógica: implantação corporativa.
Os conjuntos de sites como o nome do host não podem usar mapeamentos de acesso alternativo. Esses conjuntos de sites são automaticamente considerados como sendo 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 encaminhá-la ao servidor que está executando o Windows SharePoint Services 3.0 como http://sharepoint.courses.contoso.com:1234, o administrador irá 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
Para esse exemplo, https://sharepoint:1234 já é uma URL de AAM atribuída a um aplicativo Web e a zona Internet é usada.
Para definir a URL pública de uma zona de URL, use esta sintaxe:
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 esta sintaxe:
stsadm -o enumalternatedomains -url https://sharepoint:1234
Consulte também
Conceitos
Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls