Addalternatedomain: operação do Stsadm (Office SharePoint Server)
Atualizado em: 2007-12-13
Nome da operação: Addalternatedomain
Descrição
Adiciona uma URL interna e a mapeia para uma das cinco zonas URL de um aplicativo Web ou recurso externo.
Essa operação equivale à configuração de interface de usuário Adicionar URLs Internas que está localizada na página Mapeamentos de Acesso Alternativo do site da Administração Central do SharePoint.
Para obter mais informações, consulte Configurar mapeamento de acesso alternativo.
Sintaxe
stsadm -o addalternatedomain
** -url <Nome da URL>**
** -incomingurl <http://URL.interna>**
** -urlzone {Default | Internet | Intranet | Extranet | Custom}**
** -resourcename <nome do recurso que não seja aplicativo 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 o parâmetro url for usado, o parâmetro resourcename não poderá ser usado. |
URL do aplicativo Web. Esse parâmetro deverá ser uma URL de mapeamentos de acesso alternativo (AAM) existente que esteja atribuída a um aplicativo Web para que o stsadm possa determinar o aplicativo Web de destino. A URL pode ser pública ou interna, de qualquer zona associada ao aplicativo Web de destino. |
incomingurl |
Uma URL válida, como "http://sharepoint.courses.contoso.com:1234" |
Sim |
A URL interna que você deseja adicionar. Esse parâmetro deve se limitar às partes de esquema do protocolo, nome do host e número da porta da URL. Ele não deve conter nenhuma outra parte de uma URL. Você pode mapear várias URLs internas para a mesma zona de URL. |
urlzone |
Qualquer um dos seguintes valores:
|
Sim |
Uma das cinco zonas às quais a URL interna está associada. |
resourcename |
Um nome válido, como "Recurso1" |
Não. Entretanto, para usar esse parâmetro é preciso já ter um nome de recurso. Você pode criar um novo nome de recurso usando a operação Addzoneurl. .gif "Observação") Observação:
Se o parâmetro resourcename for usado, não será possível usar o parâmetro url.
. |
Especifica o recurso externo ao qual a URL interna deverá ser adicionada. 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
Uma zona separada que mapeia cada aplicativo Web que pode ser executado.
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, 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 determinará 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.
Mapeamentos de acesso alternativo permitem que um aplicativo Web que recebe 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 ou para a zona. Você pode associar um aplicativo Web a um conjunto de mapeamentos entre URLs internas e públicas. URLs internas são URLs de solicitações da Web conforme são recebidas pelo Microsoft Office SharePoint Server 2007. URLs públicas são URLs 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 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 pode conter apenas uma URL pública. Os conjuntos de mapeamentos correspondem às seguintes zonas de autenticação:
Padrão
Internet
Intranet
Extranet
Personalizada
Para obter informações adicionais sobre zonas e URLs e para ver um cenário de implantação corporativa de cada zona, consulte Modelo de arquitetura lógica: implantação corporativa.
Os conjuntos de sites nomeados pelo host não podem usar mapeamentos de acesso alternativo. Os conjuntos de sites nomeados pelo host são considerados automaticamente como parte 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 Internet é usada.
Para configurar uma URL interna, use a seguinte sintaxe:
stsadm -o addalternatedomain -url https://sharepoint:1234 -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234
Para mapear a URL pública para a zona da URL, use a seguinte sintaxe:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com
Dica
Pode haver apenas uma URL pública por zona de URL. Essa é a URL usada em páginas da Web ou em mensagens de email do servidor Web para o servidor proxy reverso ou para o cliente.
Para confirmar a alteração feita na URL interna, use a seguinte sintaxe:
stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234