Como criar e carregar arquivos CAB

Este tópico explica como criar arquivos CAB de ajuda atualizáveis e carregá-los no local onde os cmdlets de ajuda atualizáveis podem encontrá-los.

como criar e Upload arquivos CAB de ajuda atualizáveis

Você pode usar o recurso de ajuda atualizável para fornecer arquivos de ajuda novos ou atualizados para um módulo em vários idiomas e culturas. Um pacote de ajuda atualizável para um módulo consiste em um arquivo XML HelpInfo e um ou mais arquivos cabinet ( .CAB ). Cada arquivo CAB contém arquivos de ajuda para o módulo em uma cultura de interface do usuário. Use o procedimento a seguir para criar arquivos CAB para obter ajuda atualizável.

1. Organize os arquivos de ajuda para o módulo por cultura de interface do usuário. Cada arquivo CAB de ajuda atualizável contém os arquivos de ajuda para um módulo em uma cultura de interface do usuário. Você pode entregar vários arquivos CAB de ajuda para o módulo, cada um para uma cultura de interface do usuário diferente.

2. Verifique se os arquivos de ajuda incluem apenas os tipos de arquivo permitidos para a ajuda atualizável e validá-los em um esquema de arquivo de ajuda. Se o Update-Help cmdlet encontrar um arquivo inválido ou não for um tipo permitido, ele não instalará o arquivo inválido e interromperá a instalação de arquivos do CAB. Para obter uma lista de tipos de arquivo permitidos, consulte tipos de arquivo permitidos em um arquivo CAB de ajuda atualizável.

3. Assine digitalmente os arquivos da ajuda. As assinaturas digitais não são necessárias, mas são uma prática recomendada.

4. Inclua todos os arquivos de ajuda para o módulo na cultura da interface do usuário, não apenas arquivos que são novos ou foram alterados. Se o arquivo CAB estiver incompleto, os usuários que baixarem os arquivos da ajuda pela primeira vez ou não baixarem todas as atualizações, não terão todos os arquivos de ajuda do módulo.

5. Use um utilitário que cria arquivos de gabinete, como MakeCab.exe . O PowerShell não inclui cmdlets que criam arquivos CAB.

6. Nomeie os arquivos CAB. Para obter mais informações, consulte como nomear um arquivo CAB de ajuda atualizável.

7. Upload os arquivos CAB do módulo para o local especificado pelo elemento HelpContentUri no arquivo XML HelpInfo para o módulo. Em seguida, carregue o arquivo XML HelpInfo no local especificado pela chave HelpInfoUri do manifesto do módulo. O HelpContentUri e o HelpInfoUri podem apontar para o mesmo local.

Cuidado

O valor da chave HelpInfoUri e do elemento HelpContentUri deve começar com http ou https . O valor deve indicar um local de Internet e não deve incluir um nome de arquivo.