Novell Doc: Referencia sobre la gestión de directivas ZENworks 10 Configuration Management - Creación de directivas mediante la utilidad de línea de comandos zman

2.10 Creación de directivas mediante la utilidad de línea de comandos zman

ZENworks Configuration Management permite crear distintos tipos de directivas, como de marcadores del navegador, de usuario local dinámico, de derechos de archivo local o de impresora. Cada directiva dispone de su propio conjunto de datos y su propia configuración. Dado que es difícil pasar los datos como argumentos en la línea de comandos, la utilidad zman emplea archivos XML como entradas para crear directivas. Puede utilizar los archivos XML exportados como plantillas para crear directivas. Si desea emplear la utilidad de línea de comandos zman para crear una directiva, deberá disponer de una directiva del mismo tipo creada anteriormente mediante el Centro de control de ZENworks y exportarla a un archivo XML. Para obtener más información acerca de la creación de directivas mediante el Centro de control de ZENworks, consulte el Sección 2.0, Creación de directivas.

Por ejemplo, puede exportar una directiva de marcadores del navegador que se haya creado a través del Centro de control de ZENworks a un archivo XML y a continuación utilizar el archivo para crear otra directiva del mismo tipo mediante zman.

Un directiva puede tener contenido de archivo asociado. Por ejemplo, el controlador de impresora que se debe instalar constituye un archivo asociado con la directiva de impresoras.

Revise las siguientes secciones para crear un directiva mediante la utilidad de línea de comandos zman:

2.10.1 Creación de una directiva sin contenido

Cree un directiva en el Centro de control de ZENworks.

Por ejemplo, utilice el Centro de control de ZENworks para crear una directiva de marcadores del navegador con el nombre google que incluya un marcador a http://www.google.co.in.
Exporte la directiva a un archivo XML con el siguiente comando:

zman policy-export-to-file nombre_de_directiva nombre_de_archivo_de_directiva.xml

Por ejemplo, para exportar la directiva google a google.xml, utilice el siguiente comando: zman policy-export-to-file google google.xml

Si desea crear una directiva nueva con datos nuevos, siga con el Paso 3 Si desea crear una directiva nueva con los mismos datos que la directiva google, diríjase al Paso 4.

Modifique el archivo XML según sus necesidades.

Por ejemplo, en google.xml, cambie el valor de <URL> de http://www.google.co.in a http://www.yahoo.com en la acción browserbookmarkspolicy (directiva de marcadores del navegador) del conjunto de acciones Enforcement (aplicación) y el elemento <PolicyData> (datos de directiva) de los elementos <Actions> (acciones) y <PolicyData> (datos de directiva), como se muestra a continuación.

<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>

Cree una directiva nueva mediante el siguiente comando:

zman policy-create nombre_de_directiva_nueva nombre_de_archivo_xml_de_directiva.xml

Por ejemplo, para crear la directiva yahoo, utilice el siguiente comando:

zman policy-create yahoo google.xml

2.10.2 Creación de una directiva con contenido

Cree un directiva en el Centro de control de ZENworks.

Por ejemplo, utilice el Centro de control de ZENworks para crear un directiva de impresora del tipo iPrint, llamada directiva de iPrint, que instale automáticamente un controlador de iPrint desde el archivo controlador.zip proporcionado como contenido de la directiva y configure una impresora iPrint en el dispositivo.
Exporte la directiva a un archivo XML con el siguiente comando:

zman policy-export-to-file nombre_de_directiva nombre_de_archivo_de_directiva.xml

De este modo se crean los archivos nombre_de_archivo_de_directiva.xml y nombre_de_archivo_de_directiva_ActionContentInfo.xml.

Por ejemplo, para exportar iPrintPolicy a iPrintPolicy.xml, utilice el siguiente comando:

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

Se crearán los archivos DirectivaiPrint.xml y DirectivaiPrint_ActionContentInfo.xml. Para obtener más información acerca de ActionContentInfo.xml, consulte la Sección 2.10.3, Descripción del formato de archivo XML de directiva de zman.

Si desea crear una directiva nueva con datos nuevos, siga con el Paso 3 Si desea crear una directiva nueva con los mismos datos que DirectivaiPrint, diríjase al Paso 4.
Modifique los archivos DirectivaiPrint.xml e DirectivaiPrint_actioncontentinfo.xml como sea necesario.

Por ejemplo, para crear una directiva nueva para configurar e instalar otra impresora iPrint en la red con una versión nueva del controlador, haga lo siguiente:
- Cambie todas las referencias de controlador.zip a nuevo_controlador.zip en las secciones <ActionSet> (Conjunto de acciones) y <PolicyData> (Datos de directiva) de directiva_iPrint.xml y en la sección <ActionSet> (Conjunto de acciones) de directiva_iPrint_actioncontentinfo.xml.
- Sustituya el nombre de la impresora en el archivo directiva_iPrint.xml con el nuevo nombre de la impresora.
A continuación se muestra un archivo directiva_iPrint_actioncontentinfo.xml de ejemplo.
```
<ActionInformation>
```
```
 <ActionSet type="Enforcement">
```
```
  <Action name="printer policy" index="1">
```
```
   <Content>
```
```
     <ContentFilePath>driver.zip</ContentFilePath>
```
```
   </Content>
```
```
  </Action>
```
```
 </ActionSet>
```
```
</ActionInformation>
```
Cree una directiva nueva mediante el siguiente comando:

zman policy-create nombre_de_directiva_nueva nombre_de_archivo_xml_de_directiva.xml --actioninfo nombre_de_directiva_actioncontentinfo.xml

Por ejemplo, utilice el siguiente comando para crear una directiva llamada directiva_iPrint_nueva:

zman policy-create Nueva_DirectivaiPrint DirectivaiPrint.xml --actioninfo DirectivaiPrint_ActionContentInfo.xml

2.10.3 Descripción del formato de archivo XML de directiva de zman

El comando policy-export-to-file permite crear series con la información de directivas, que se almacena en la base de datos, en un archivo XML. Cada directiva incluye acciones que se agrupan en conjuntos de acciones, aplicación y distribución. Un archivo XML de directiva exportado incluye información relacionada con la directiva como, por ejemplo, el UID, el nombre, la vía, el tipo principal, el tipo secundario, los datos de directiva o los requisitos de sistema, así como información sobre todos los conjuntos de acciones y las acciones correspondientes. El archivo no incluye información acerca de la asignación de la directiva a dispositivos o usuarios.

Encontrará una plantilla de formato XML de ejemplo, WindowsGroupPolicy.xml, en /opt/novell/zenworks/share/zman/samples/policies en servidores Linux y en directorio_de_instalación_ de_ZENworks:\Novell\Zenworks\share\zman\samples\policies en servidores Windows.

NOTA:si el archivo XML exportado contiene caracteres ASCII extendidos, deberá abrirlo en un editor usando la codificación UTF-8 en lugar de la codificación ANSI, dado que con esta última los caracteres ASCII extendidos no se muestran correctamente.

Cuando se crea una directiva desde el archivo XML, zman emplea la información especificada en las etiquetas <Description> (Descripción), <SubType> (Subtipo),<Category> (Categoría), <ActionSets> (Conjuntos de acciones), <PolicyData> (Datos de directiva) y <SysReqs> (Requisitos de sistema) del archivo. Los valores del nombre y de la carpeta padre se toman de la línea de comandos. Para el resto de elementos, se usan los valores por defecto.

Siga las instrucciones que se indican a continuación para trabajar con el archivo XML:

Si desea crear una directiva sin contenido de archivo, sólo necesitará el archivo XML de la directiva para crearla.

Por ejemplo, la directiva de derechos de archivo local no tiene contenido de archivo asociado.
Si desea crear una directiva con contenido, debe proporcionar un archivo XML adicional que contenga la vía al archivo de contenido, como argumento de la opción -–actioninfo del comando policy-create.

Por ejemplo, la directiva de impresora puede tener los controladores de la impresora que se deben instalar asociados como contenido de archivo.

Encontrará una plantilla de formato XML de ejemplo, ActionInfo.xml, en /opt/novell/zenworks/share/zman/samples/policies en servidores Linux y en directorio_de_instalación_ de_ZENworks:\Novell\Zenworks\share\zman\samples\policies en servidores Windows.
Si desea modificar el elemento <Data> (Datos) de las acciones del archivo XML exportado, asegúrese de que los nuevos datos son correctos y de que se ajustan al esquema. La utilidad zman efectúa una validación mínima de los datos y no comprueba si contienen errores. Por lo tanto, es posible que la directiva se cree correctamente, pero que incluya datos no válidos. En ese caso, la directiva fallará cuando se distribuya a un dispositivo gestionado.
El contenido de archivo se asocia con una acción específica de un conjunto de acciones. El archivo XML de información de contenido de la acción debe incluir la vía del archivo al que se debe asociar el contenido y el índice de la acción del conjunto de acciones.

Por ejemplo, el controlador de impresora seleccionado para instalarlo al crear una directiva de impresora se asocia a la acción de directiva de impresora del conjunto de acciones de aplicación de la directiva de impresora creada.
El conjunto de acciones se especifica en el atributo de tipo del elemento <ActionSet> (conjunto de acciones). Debe tratarse del mismo tipo del conjunto de acciones del archivo XML de la directiva.
El elemento <Action> (acción) dispone de un atributo de nombre que es opcional para facilitar la lectura por parte del usuario.
El atributo index (índice) es obligatorio. Hace referencia a la acción a la que se debe asociar el contenido. El valor de índice de la primera acción del conjunto de acciones es 1.
Cada acción puede incluir varios elementos <Content> (contenido) y éstos, a su vez, incluir un elemento <ContentFilePath> (vía al archivo de contenido). El elemento <ContentFilePath> (vía al archivo de contenido) muestra la vía al contenido de archivo que se debe asociar a la acción. Asegúrese de que el nombre de archivo coincida con el nombre de archivo especificado en el archivo XML de la directiva, en el campo <Data> (Datos) correspondiente a la acción.
Asegúrese de que el orden de los elementos <Content> (Contenido) coincida con el orden del archivo XML de la directiva. Por ejemplo, una directiva de impresora puede tener varios controladores configurados. La vía a los archivos de los controladores se debe especificar en los elementos <Content> (Contenido) en el orden en el que los archivos están especificados en los datos de la acción, como se muestra a continuación.
```
<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>
```