Partilhar via

Implantar e gerenciar instalações de Ajuda locais para ambientes de rede

Você pode usar o Microsoft Help Viewer para instalar, exibir e gerenciar instalações de documentação local para produtos e tecnologias da Microsoft em computadores locais. Essas tecnologias incluem Visual Studio, .NET, referência de linguagem, SQL Server e desenvolvimento do Windows.

Neste artigo, você aprenderá a usar o Visualizador da Ajuda para implantar e gerenciar instalações locais da Ajuda para ambientes de rede com ou sem acesso à Internet. O conteúdo da ajuda local é configurado por máquina. Por padrão, os usuários devem ter direitos de administrador para atualizar a instalação da Ajuda local.

Se o seu ambiente de rede permitir que os clientes acessem a Internet, você poderá usar o executável do Gerenciador de Conteúdo da Ajuda para implantar o conteúdo local da Ajuda da Internet. Para obter mais informações sobre HlpCtntMgr.exesintaxe da linha de comando , consulte Argumentos de linha de comando para o Gestor de Conteúdos de Ajuda.

Para obter informações sobre como criar conteúdo, criar um ponto de extremidade de serviço de intranet e atividades semelhantes, consulte o SDK do Visualizador de Ajuda.

Se não tiver acesso à internet na sua configuração de rede, o Visualizador de Ajuda pode implantar conteúdo de ajuda local a partir da intranet ou de uma partilha de rede. Você também pode desabilitar as opções de Ajuda do IDE do Visual Studio usando alterações de chave de registo para funcionalidades como:

  • Ajuda online versus offline

  • instalação de conteúdo no primeiro lançamento do IDE

  • Especificando um serviço de conteúdo da intranet

  • gerenciando conteúdo

Implantar conteúdo de Ajuda local da Internet

Você pode usar o Gerenciador de Conteúdo da Ajuda (HlpCtntMgr.exe) para implantar o conteúdo da Ajuda local da Internet nos computadores clientes. Utilize a seguinte sintaxe:

\\%ProgramFiles(x86)%\Microsoft Help Viewer\v2.3\HlpCtntmgr.exe /operation \<*name*> /catalogname \<*catalog name*> /locale \<*locale*>

Para obter mais informações sobre HlpCtntMgr.exesintaxe da linha de comando , consulte Argumentos de linha de comando para o Gestor de Conteúdos de Ajuda.

Requisitos:

  • Os computadores clientes devem ter acesso à Internet.

  • Os usuários devem ter direitos de administrador para atualizar, adicionar ou remover o conteúdo da Ajuda local depois que ele for instalado.

Advertências:

  • A fonte padrão da Ajuda ainda estará online.

Exemplo

O exemplo a seguir instala conteúdo em inglês para Visual Studio em um computador cliente.

Para instalar conteúdo em inglês da internet

  1. Escolha Iniciar e, em seguida, escolha Executar.

  2. Digite o seguinte:

    C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us

  3. Pressione Enter.

Implantar conteúdo da Ajuda local pré-instalado em computadores clientes

Pode instalar um conjunto de conteúdos online num computador e, em seguida, copiar esse conjunto de conteúdos instalado para outros computadores.

Requisitos:

  • O computador no qual você instala o conjunto de conteúdo deve ter acesso à Internet.

  • Os usuários devem ter direitos de administrador para atualizar, adicionar ou remover o conteúdo da Ajuda local depois que ele for instalado.

    Sugestão

    Se os usuários não tiverem direitos de administrador, é recomendável desabilitar a guia Gerenciar Conteúdo no Visualizador da Ajuda. Para obter mais informações, consulte Substituir configurações padrão do Visualizador da Ajuda.

Advertências:

  • A fonte padrão da Ajuda ainda estará online.

Criar o conjunto de conteúdo

Antes de criar o conjunto de conteúdo base, você deve primeiro desinstalar todo o conteúdo local do Visual Studio no computador de destino.

Para desinstalar a ajuda local

  1. No Visualizador de Ajuda, escolha a guia Gerenciar conteúdo .

  2. Navegue até o conjunto de documentos do Visual Studio.

  3. Escolha Remover ao lado de cada subitem.

  4. Escolha Atualizar para desinstalar.

  5. Navegue até %ProgramData%\Microsoft\HelpLibrary2\Catalogs\VisualStudio15 e verifique se a pasta contém apenas o arquivo catalogType.xml.

    Depois de remover todo o conteúdo da Ajuda do Visual Studio local instalado anteriormente, você estará pronto para baixar o conjunto de conteúdo base.

Para baixar o conteúdo

  1. No Visualizador de Ajuda, escolha a guia Gerenciar conteúdo .

  2. Em Documentação recomendada ou Documentação disponível, navegue até os conjuntos de documentação que deseja baixar e escolha Adicionar.

  3. Escolha Atualizar.

Em seguida, você precisa empacotar o conteúdo para que ele possa ser implantado nos computadores clientes.

Para empacotar o conteúdo

  1. Crie uma pasta para copiar o conteúdo para implantação posterior. Por exemplo: C:\VSHelp.

  2. Abra cmd.exe com permissões de administrador.

  3. Navegue até a pasta criada na etapa 1.

  4. Digite o seguinte:

    Xcopy %ProgramData%\Microsoft\HelpLibrary2 \<*foldername*>\ /y /e /k /o

    Por exemplo: Xcopy %ProgramData%\Microsoft\HelpLibrary2 c:\VSHelp\ /y /e /k /o

Implantar o conteúdo

  1. Crie um compartilhamento de rede e copie o conteúdo da ajuda para esse local.

    Por exemplo, copie o conteúdo em C:\VSHelp para \\myserver\VSHelp.

  2. Crie um arquivo .bat para conter o script de implantação para o conteúdo da ajuda. Como o cliente pode ter um bloqueio de leitura em qualquer um dos arquivos que estão sendo excluídos como parte do push, você deve desligar o cliente antes de enviar atualizações. Por exemplo:

    REM - copy pre-ripped content to ProgramData
Xcopy %~dp0HelpLibrary2 %SYSTEMDRIVE%\ProgramData\Microsoft\HelpLibrary2\ /y /e /k /o
if ERRORLEVEL 1 ECHO *** ERROR COPYING Help Library files to ProgramData (%ERRORLEVEL%)

  3. Execute o arquivo .bat nas máquinas locais nas quais você deseja instalar o conteúdo da Ajuda.

Conteúdo relacionado

  • Last updated on