Novell Doc: Referência de Gerenciamento de Políticas do ZENworks 10 Configuration Management - Criando políticas com o utilitário de linha de comando zman

2.10 Criando políticas com o utilitário de linha de comando zman

O ZENworks Configuration Management permite criar tipos de políticas diferentes, como política de Marcadores do Browser, política de Usuário Local Dinâmico, política de Direitos de Arquivo Local e política de Impressora. Cada política tem seu próprio conjunto de dados e definições de configuração. Devido à complexidade de se transmitir dados como argumentos na linha de comando, o utilitário zman usa arquivos XML como entrada para criar políticas. Você pode usar arquivos XML exportados como gabaritos para criar políticas. Para usar o utilitário de linha de comando zman para criar uma política, é necessário já ter uma política do mesmo tipo criada pelo ZENworks Control Center e exportá-la para um arquivo XML. Para obter mais informações sobre como criar políticas usando o ZENworks Control Center, consulte o Seção 2.0, Criando políticas.

Por exemplo, você pode exportar uma Política de Marcadores do Browser criada pelo ZENworks Control Center para um arquivo XML e usá-lo para criar outra Política de Marcadores do Browser usando o zman.

A política pode ter um conteúdo de arquivo associado a ela. Por exemplo, o driver de impressora a ser instalado é um arquivo associado à política de Impressora.

Verifique as seções a seguir para criar uma política com o utilitário de linha de comando zman:

2.10.1 Criando uma política sem conteúdo

Crie uma política no ZENworks Control Center.

Por exemplo, use o ZENworks Control Center para criar uma Política de Marcadores do Browser chamada google contendo o marcador http://www.google.co.in.
Exporte a política para um arquivo XML usando o seguinte comando:

zman policy-export-to-file nome_da_política nome_do_arquivo_de_política.xml

Por exemplo, exporte a política google para google.xml usando o seguinte comando: zman policy-export-to-file google google.xml

Se desejar criar uma nova política com novos dados, continue na Etapa 3. Se desejar criar uma nova política com os mesmos dados da política google, vá para a Etapa 4.

Modifique o arquivo XML de acordo com seus requisitos.

Por exemplo, no arquivo google.xml, mude o valor de <URL> de http://www.google.co.in para http://www.yahoo.com na ação browserbookmarkspolicy do conjunto de ações Enforcement e o elemento <PolicyData> nos elementos <Actions> e <PolicyData>, conforme mostrado a seguir.

<ns2:ActionSets>

 <Id>879de60b7591b6f6aefae09fcd83db54</Id>

 <Type>Enforcement</Type>

 <Version>1</Version>

 <Modified>false</Modified>

  <Actions>

   <Id>0ab9a1785370bcd38bc862bd2817abac</Id>

    <Name>browserbookmarkspolicy</Name>

     <Type>browserbookmarkspolicy</Type>

      <Data>

       <PolicyData xmlns="http://novell.com/zenworks/datamodel/objects/policies">

        <BookmarksPolicyHandlerData xmlns="">

         <EnforcePolicy>

          <Bookmarks>

           <Bookmark Type="url_string">

             <Name>Google</Name>

             <Url>http://www.yahoo.com</Url>

             <Folder>/</Folder>

           </Bookmark>

          </Bookmarks>

         </EnforcePolicy>

        </BookmarksPolicyHandlerData>

       </PolicyData>

      </Data>

  <ContinueOnFailure>true</ContinueOnFailure>

  <Enabled>true</Enabled>

<Properties>StandaloneName=browserbookmarksenf;Impersonation=SYSTEM;</Properties>

</Actions>

</ns2:ActionSets>

<ns2:ActionSets xmlns:ns2="http://novell.com/zenworks/datamodel/objects/actions" xmlns="http://novell.com/zenworks/datamodel/objects/actions">

  <Id>4efa37c827cf0e8a8ac20b23a3022227</Id>

  <Type>Distribution</Type>

  <Version>1</Version>

  <Modified>false</Modified>

   <Actions>

    <Id>27c4a42544210b3ac3b067ff6aff2d5c</Id>

    <Name>Distribute Action</Name>

    <Type>Distribute Action</Type>

    <ContinueOnFailure>true</ContinueOnFailure>

    <Enabled>true</Enabled>

    <Properties />

   </Actions>
 </ns2:ActionSets>

 <ApplyImmediate>false</ApplyImmediate>

 <PolicyData>

  <BookmarksPolicyHandlerData>

    <EnforcePolicy>

      <Bookmarks>

        <Bookmark Type="url_string">

          <Name>Google</Name>

          <Url>http://www.yahoo.com</Url>

          <Folder>/</Folder>

        </Bookmark>

      </Bookmarks>

    </EnforcePolicy>

  </BookmarksPolicyHandlerData>

</PolicyData>

Crie uma nova política usando o seguinte comando:

zman policy-create nome_da_nova_política nome_do_arquivo_xml_de_política.xml

Por exemplo, para criar a política yahoo, use o seguinte comando:

zman policy-create yahoo google.xml

2.10.2 Criando uma política com conteúdo

Crie uma política no ZENworks Control Center.

Por exemplo, use o ZENworks Control Center para criar uma política de Impressora do tipo iPrint chamada Política do iPrint, que instala automaticamente um driver do iPrint do arquivo driver.zip, fornecido como o conteúdo da política, e configura uma impressora do iPrint no dispositivo.
Exporte a política para um arquivo XML usando o seguinte comando:

zman policy-export-to-file nome_da_política nome_do_arquivo_de_política.xml

Essa ação cria os arquivos nome_do_arquivo_de_política.xml e nome_do_arquivo_de_política_ActionContentInfo.xml.

Por exemplo, exporte a política iPrintPolicy para iPrintPolicy.xml usando o seguinte comando:

zman policy-export-to-file iPrintPolicy iPrintPolicy.xml

Os arquivos iPrintPolicy.xml eiPrintPolicy_ActionContentInfo.xml são criados. Para obter mais informações sobre ActionContentInfo.xml, consulte a Seção 2.10.3, Compreendendo o formato de arquivo XML de política do zman.

Se desejar criar uma nova política com novos dados, continue na Etapa 3. Se desejar criar uma nova política com os mesmos dados de iPrintPolicy, vá para a Etapa 4.
Modifique os arquivos iPrintPolicy.xml e iPrintPolicy_actioncontentinfo.xml de acordo com seus requisitos.

Por exemplo, para criar uma nova política para configurar e instalar outro iPrint na rede com uma versão mais recente do driver, faça o seguinte:
- Mude todas as referências de driver.zip para newDriver.zip nas seções <ActionSet> e <PolicyData> do iPrintPolicy.xml, e na seção <ActionSet> do iPrintPolicy_actioncontentinfo.xml.
- Substitua o nome da impressora no arquivo iPrintPolicy.xml pelo novo nome da impressora.
Veja a seguir um exemplo do arquivo iPrintPolicy_actioncontentinfo.xml.
```
<ActionInformation>
```
```
 <ActionSet type="Enforcement">
```
```
  <Action name="printer policy" index="1">
```
```
   <Content>
```
```
     <ContentFilePath>driver.zip</ContentFilePath>
```
```
   </Content>
```
```
  </Action>
```
```
 </ActionSet>
```
```
</ActionInformation>
```
Crie uma nova política usando o seguinte comando:

zman policy-create nome_da_nova_política nome_do_arquivo_xml_de_política.xml --actioninfo nome_da_política_actioncontentinfo.xml

Por exemplo, use o seguinte comando para criar uma política chamada New_iPrintPolicy:

zman policy-create New_iPrintPolicy iPrintPolicy.xml --actioninfo iPrintPolicy_ActionContentInfo.xml

2.10.3 Compreendendo o formato de arquivo XML de política do zman

O comando policy-export-to-file serializa as informações de política, que são armazenadas no banco de dados, em um arquivo XML. Cada política contém ações que são agrupadas em Conjuntos de Ações, Uso Obrigatório e Distribuição. Um arquivo XML de política exportado contém informações sobre a política, como UID, Name, Path, PrimaryType, SubType, PolicyData, System Requirements e informações sobre todos os Conjuntos de Ações e suas ações. O arquivo não contém informações sobre a atribuição da política a dispositivos ou usuários.

Um gabarito de exemplo no formato XML, WindowsGroupPolicy.xml, está disponível em /opt/novell/zenworks/share/zman/samples/policies em um servidor Linux e em diretório_de_instalação_do_ZENworks:\Novell\ Zenworks\share\zman\ samples\policies em um servidor Windows.

NOTA:Se o arquivo XML exportado contiver caracteres ASCII estendidos, abra-o em um editor usando a codificação UTF-8 em vez da codificação ANSI, pois esta exibe os caracteres ASCII estendidos truncados.

Quando você cria uma política com base em um arquivo XML, o zman usa as informações especificadas nas tags <Description>, <SubType>,<Category>, <ActionSets>, <PolicyData> e <SysReqs> do arquivo. Os valores para o nome e a pasta pai são extraídos da linha de comando. Para os demais elementos, é usado o valor padrão.

Siga as instruções a seguir para trabalhar com o arquivo XML:

Para criar uma política sem conteúdo de arquivo, é necessário somente o arquivo XML de política.

Por exemplo, não há conteúdo de arquivo associado à Política de Direitos Arquivo Local.
Se você deseja criar uma política com conteúdo, forneça um arquivo XML adicional, que contenha o caminho do arquivo de conteúdo, como um argumento para a opção -–actioninfo do comando policy-create.

Por exemplo, a política de Impressora pode determinar a instalação dos drivers de impressora como conteúdo de arquivo associado.

Um gabarito de exemplo no formato XML, ActionInfo.xml, está disponível em /opt/novell/zenworks/share/zman/samples/policies em um servidor Linux e em diretório_de_instalação_do_ZENworks:\Novell\ Zenworks\share\zman\ samples\policies em um servidor Windows.
Para modificar o elemento <Data> das ações no arquivo XML exportado, verifique se os novos dados estão corretos e em conformidade com o esquema. O utilitário zman faz uma validação mínima dos dados e não verifica se há erros. Dessa forma, mesmo que a política seja criada corretamente, é possível que contenha dados inválidos. Essa política falhará ao ser distribuída para um dispositivo gerenciado.
O conteúdo do arquivo é associado a uma ação específica de um Conjunto de Ações. O arquivo XML de Informações de Conteúdo de Ação deve conter o caminho do arquivo ao qual o conteúdo de arquivo deve ser associado e o índice da ação do Conjunto de Ações.

Por exemplo, o driver de Impressora selecionado para instalação na criação de uma política de Impressora é associado à ação printerpolicy do conjunto de ações de Uso Obrigatório da política de Impressora criada.
O Conjunto de Ações é especificado pelo atributo de tipo no elemento <ActionSet>. Ele deve ser o mesmo que o tipo de Conjunto de Ações do arquivo XML de política.
O elemento <Action> tem um atributo de nome, opcional, para facilitar a leitura do usuário.
O atributo index é obrigatório. Ele especifica a ação à qual o conteúdo deve ser associado. O valor do índice da primeira ação no Conjunto de Ações é 1.
Cada ação pode ter vários elementos <Content>, cada um contendo um elemento <ContentFilePath>. O elemento <ContentFilePath> contém o caminho do conteúdo de arquivo a ser associado à Ação. Verifique se o nome do arquivo é o mesmo especificado no arquivo XML da política em <Data> para essa ação.
Verifique se a ordem dos elementos <Content> está de acordo com a ordem no arquivo XML de política. Por exemplo, uma política de Impressora pode ter vários drivers configurados. O caminho para os arquivos de driver deve ser especificado nos elementos <Content> na ordem em que os arquivos são especificados nos dados da ação, como mostrado abaixo.
```
<ActionInformaion>
```
```
 <ActionSet type="Enforcement">
```
```
  <Action name="printer policy" index="1">
```
```
   <Content>
```
```
    <ContentFilePath>driver1.zip</ContentFilePath>
```
```
   </Content>
```
```
   <Content>
```
```
      <ContentFilePath>driver2.zip</ContentFilePath>
```
```
   </Content>
```
```
  </Action>
```
```
 </ActionSet>
```
```
</ActionInformation>
```