Compartilhar via

Implantar e gerenciar instalações locais de Ajuda 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 Help Viewer para implantar e gerenciar instalações locais de Ajuda para ambientes de rede com ou sem acesso à Internet. O conteúdo da ajuda local é configurado em cada máquina. Por padrão, os usuários devem ter direitos de administrador para atualizar a instalação da Ajuda local.

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

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

Se você não tiver acesso à Internet em seu ambiente de rede, o Help Viewer poderá implantar o conteúdo da Ajuda local da intranet ou de um compartilhamento de rede. Você também pode desabilitar as opções da Ajuda do IDE do Visual Studio usando substituições de chave do Registro para as funcionalidades, como:

  • ajuda online e offline

  • instalação de conteúdo no início do IDE

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

  • gerenciando conteúdo

Implantar o conteúdo da Ajuda local a partir da internet

Você pode usar o Gerenciador de Conteúdo da Ajuda (HlpCtntMgr.exe) para implantar o conteúdo da Ajuda local da Internet em computadores cliente. Use 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.exe sintaxe de linha de comando, consulte argumentos de linha de comando para o Gerenciador de Conteúdo da Ajuda.

Requisitos:

  • Os computadores cliente 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 tiver sido instalado.

Restrições:

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

Exemplo

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

Para instalar o conteúdo em inglês da Internet

  1. Escolha Iniciar e 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 de Ajuda local pré-instalado em computadores cliente

Você pode instalar um conjunto de conteúdo de online para um computador e copiar esse conjunto de conteúdo instalado para outros computadores.

Requisitos:

  • O computador para o 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 tiver sido instalado.

    Dica

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

Restrições:

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

Criar o conjunto de conteúdo

Antes de criar o conjunto de conteúdo base, primeiro você deve 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 sub-item.

  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 local do Visual Studio 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 você deseja baixar e escolha Adicionar.

  3. Escolha Atualizar.

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

Para empacotar o conteúdo

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

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

  3. Navegue até a pasta que você criou 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 fazer com que o cliente seja desligado antes de enviar atualizações por push. 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 nos computadores locais nos quais você deseja instalar o conteúdo da Ajuda.

Conteúdo relacionado

  • Last updated on