2.10 Erstellen von Richtlinien unter Verwendung des zman-Befehlszeilenprogramms

Mit ZENworks Configuration Management können Sie verschiedene Richtlinientypen erstellen, wie zum Beispiel die Richtlinie für Browser-Lesezeichen, die Richtlinie für dynamischen lokalen Benutzer, die Richtlinie für lokale Dateirechte und die Druckerrichtlinie. Jede Richtlinie verfügt über einen eigenen Datensatz und eigene Konfigurationseinstellungen. Da es ein komplexer Vorgang ist, Daten als Argumente in der Befehlszeile zu übertragen, werden für die Erstellung von Richtlinien im zman-Dienstprogramm XML-Dateien als Eingabe benötigt. Sie können exportierte XML-Dateien als Vorlagen zum Erstellen von Richtlinien verwenden. Um das zman-Befehlszeilenprogramm für die Erstellung einer Richtlinie verwenden zu können, müssen Sie bereits eine Richtlinie des gleichen Typs mithilfe des ZENworks-Kontrollzentrums erstellt haben und sie als XML exportieren. Weitere Informationen zur Erstellung von Richtlinien mithilfe des ZENworks-Kontrollzentrums finden Sie unter Abschnitt 2.0, Erstellen von Richtlinien.

Sie können beispielsweise eine Richtlinie für Browser-Lesezeichen, die Sie bereits im ZENworks-Kontrollzentrum erstellt haben, in eine XML-Datei exportieren und diese anschließend dazu verwenden, um mithilfe von zman eine weitere Richtlinie für Browser-Lesezeichen zu erstellen

Eine Richtlinie kann mit dem Inhalt einer Datei verknüpft werden. Beispielsweise ist der zu installierende Druckertreiber eine Datei, die mit der Druckerrichtlinie verknüpft ist.

In den folgenden Abschnitten erhalten Sie Informationen zum Erstellen von Richtlinien unter Verwendung des zman-Befehlszeilenprogramms:

2.10.1 Erstellen einer Richtlinie ohne Inhalt

  1. Erstellen Sie eine Richtlinie im ZENworks-Kontrollzentrum.

    Zum Beispiel können Sie im ZENworks-Kontrollzentrum eine Richtlinie für Browser-Lesezeichen erstellen, die Sie als "google" bezeichnen und die ein Lesezeichen für "http://www.google.co.in" enthält.

  2. Exportieren Sie die Richtlinie unter Verwendung des folgenden Befehls in eine XML-Datei:

    zman policy-export-to-file policy_name policy_filename.xml

    Exportieren Sie beispielsweise die google-Richtlinie mithilfe des Befehls zman policy-export-to-file google google.xml in die Datei google.xml

    Soll eine neue Richtlinie mit neuen Daten erstellt werden, fahren Sie mit Schritt 3 fort. Wenn eine neue Richtlinie mit den gleichen Daten wie die google-Richtlinie erstellt werden soll, fahren Sie mit Schritt 4 fort.

  3. Bearbeiten Sie die XML-Datei entsprechend Ihren Anforderungen.

    Beispiel: Ändern Sie in google.xml den Wert der <URL> von http://www.google.co.in zu http://www.yahoo.com in der Aktion browserbookmarkspolicy des Aktionssatzes Durchsetzung sowie das Element <Richtliniendaten> in den beiden Elementen <Aktionen> und <Richtliniendaten> (siehe folgende Abbildung).

    <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>
    
  4. Erstellen Sie eine neue Richtlinie unter Verwendung des folgenden Befehls:

    zman policy-create new_policy_name policy_xml_filename.xml

    Um beispielsweise die yahoo-Richtlinie zu erstellen, verwenden Sie folgenden Befehl:

    zman policy-create yahoo google.xml

2.10.2 Erstellen einer Richtlinie mit Inhalt

  1. Erstellen Sie eine Richtlinie im ZENworks-Kontrollzentrum.

    Beispiel: Erstellen Sie im ZENworks-Kontrollzentrum eine Druckerrichtlinie des Typs iPrint, die Sie iPrint-Richtlinie nennen und die automatisch einen iPrint-Drucker aus der Datei driver.zip, die als Richtlinieninhalt dient, installiert und einen iPrint-Drucker auf dem Gerät konfiguriert.

  2. Exportieren Sie die Richtlinie unter Verwendung des folgenden Befehls in eine XML-Datei:

    zman policy-export-to-file policy_name policy_filename.xml

    Auf diese Weise werden die Dateien policy_filename.xml und policy_filename_ActionContentInfo.xml erstellt.

    Beispiel: Exportieren Sie die iPrint-Richtlinie in die Datei iPrintPolicy.xml mithilfe des folgenden Befehls:

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

    Die Dateien iPrintPolicy.xml und iPrintPolicy_ActionContentInfo.xml werden erstellt. Weitere Informationen zu ActionContentInfo.xml finden Sie unter Abschnitt 2.10.3, Erläuterungen zum XML-Dateiformat für zman-Richtlinien.

    Wenn eine neue Richtlinie mit neuen Daten erstellt werden soll, fahren Sie mit Schritt 3 fort. Wenn eine neue Richtlinie mit den gleichen Daten wie bei der iPrint-Richtlinie erstellt werden soll, fahren Sie mit Schritt 4 fort.

  3. Bearbeiten Sie die Dateien iPrintPolicy.xml und iPrintPolicy_actioncontentinfo.xml entsprechend Ihren Anforderungen.

    Um beispielsweise eine neue Richtlinie zu erstellen, die einen weiteren iPrint-Drucker im Netzwerk mit einer neueren Treiberversion installiert, gehen Sie wie folgt vor:

    • Ändern Sie alle Referenzen auf driver.zip zu newDriver.zip im Abschnitt <Aktionssatz> und <Richtliniendaten> der Datei iPrintPolicy.xml sowie im Abschnitt <Aktionssatz> der Datei iPrintPolicy_actioncontentinfo.xml.

    • Ersetzen Sie den Namen des Druckers in der Datei iPrintPolicy.xml durch den neuen Namen des Druckers.

    Die Datei iPrintPolicy_actioncontentinfo.xml wird nachfolgend als Beispiel angezeigt.

    <ActionInformation>
    
     <ActionSet type="Enforcement">
    
      <Action name="printer policy" index="1">
    
       <Content>
    
         <ContentFilePath>driver.zip</ContentFilePath>
    
       </Content>
    
      </Action>
    
     </ActionSet>
    
    </ActionInformation>
    
  4. Erstellen Sie eine neue Richtlinie unter Verwendung des folgenden Befehls:

    zman policy-create new_policy_name policy_xml_filename.xml --actioninfo policy_name_actioncontentinfo.xml

    Verwenden Sie beispielsweise den folgenden Befehl, um eine Richtlinie mit dem Namen "Neue iPrint-Richtlinie" zu erstellen:

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

2.10.3 Erläuterungen zum XML-Dateiformat für zman-Richtlinien

Der Befehl policy-export-to-file serialisiert die Richtlinien-Informationen, die in der Datenbank gespeichert sind, in eine XML-Datei. Jede Richtlinie enthält Aktionen, die in "Aktionsatz", "Durchsetzung" und "Distribution" gruppiert sind. Eine exportierte Richtlinien-XML-Datei enthält Informationen für die Richtlinie, darunter UID, Name, Pfad, primärer Typ, Teiltyp, Richtliniendaten, Systemanforderungen sowie Informationen zu allen Aktionssätzen und deren Aktionen. Die Datei enthält keine Informationen über die Zuweisung der Richtlinie zu Geräten oder Benutzern.

Eine XML-Beispielformatvorlage, WindowsGroupPolicy.xml, finden Sie unter /opt/novell/zenworks/share/zman/samples/policies auf einem Linux-Server und unter ZENworks_Installation_directory:\Novell\Zenworks\share\zman\samples\policies auf einem Windows-Server.

HINWEIS:Falls die exportierte XML-Datei Zeichen des erweiterten ASCII-Codes enthält, müssen Sie die UTF-8- statt der ANSI-Codierung verwenden, um die Datei in einem Editor zu öffnen. Der Grund dafür ist, dass ANSI die Zeichen des erweiterten ASCII-Codes nicht richtig darstellt.

Wenn Sie eine Richtlinie aus einer XML-Datei erstellen, verwendet zman die Informationen, die in den Dateielementen <Beschreibung>, <Teiltyp>, <Kategorie> und <Aktionssatz> sowie <Systemanforderungen> angegeben werden. Die Werte für den Namen und den übergeordneten Ordner werden der Befehlszeile entnommen. Für die restlichen Elemente werden die Standardwerte verwendet.

Befolgen Sie die nachstehenden Richtlinien, wenn Sie mit der XML-Datei arbeiten:

  • Wenn eine Richtlinie ohne Dateiinhalt erstellt werden soll, ist zur Erstellung der Richtlinie nur die Richtlinien-XML-Datei erforderlich.

    Beispielsweise sind mit einer Richtlinie für lokale Dateirechte keine Inhalte verknüpft.

  • Wenn eine Richtlinie mit Inhalt erstellt werden soll, müssen Sie eine zusätzliche XML-Datei angeben, die den Pfad zur Inhaltsdatei als Argument zur Option --actioninfo des Befehls policy-create enthält.

    Eine Druckerrichtlinie kann beispielsweise dafür sorgen, dass die Druckertreiber als verknüpfte Dateiinhalte installiert werden.

    Eine XML-Beispielformatvorlage, ActionInfo.xml, finden Sie unter /opt/novell/zenworks/share/zman/samples/policies auf einem Linux-Server und unter ZENworks_Installation_directory:\Novell\Zenworks\share\zman\ samples\policies auf einem Windows-Server.

  • Wenn das Aktionselement <Daten> in der exportierten XML-Datei bearbeitet werden soll, vergewissern Sie sich, dass die neuen Daten korrekt und mit dem Schema konform sind. Das zman-Dienstprogramm führt nur eine minimale Validierung der Daten durch und überprüft diese nicht auf Fehler. So wird die Richtlinie zwar erfolgreich erstellt, enthält aber möglicherweise ungültige Daten. In diesem Fall funktioniert die Richtlinie auf einem verwalteten Gerät nicht ordnungsgemäß.

  • Dateiinhalte werden mit einer bestimmten Aktion in einem Aktionssatz verknüpft. Die XML-Datei mit den Aktionsinhaltsinformationen sollte den Pfad der Datei, mit der der Dateiinhalt verknüpft werden soll, sowie den Index der Aktion im Aktionssatz enthalten.

    Beispielsweise wird der zu installierende Druckertreiber, der bei der Erstellung der Druckerrichtlinie ausgewählt wurde, mit der Druckerrichtlinienaktion im Aktionssatz "Durchsetzung" der erstellten Druckerrichtlinie verknüpft.

  • Der Aktionssatz wird durch das Typenattribut im Element <Aktionssatz> angegeben. Dieses Attribut sollte in der Richtlinien-XML-Datei denselben Wert haben.

  • Das Element <Action> hat ein optionales Namensattribut, das der Leserlichkeit dient.

  • Das Attribut index ist obligatorisch. Es gibt die Aktion an, mit der der Inhalt verknüpft werden soll. Der Wert des Attributs der ersten Aktion im Aktionssatz ist 1.

  • Jede Aktion kann mehrere <Content>-Elemente haben, von denen jedes ein <ContentFilePath>-Element enthält. Das Element <ContentFilePath> enthält den Pfad des Dateiinhalts, der mit der Aktion verknüpft werden soll. Vergewissern Sie sich, dass der Dateiname dem in der Richtlinien-XML-Datei unter <Daten> angegebenen Dateinamen für diese Aktion entspricht.

  • Vergewissern Sie sich, dass die Reihenfolge der <Inhalt>-Elemente der Reihenfolge der Elemente in der Richtlinien-XML-Datei entspricht. Beispielsweise können bei einer Druckerrichtlinie mehrere Treiber konfiguriert sein. Der Pfad zu den Treiberdateien sollte in den <Inhalt>-Elementen angegeben werden, und zwar in der Reihenfolge, in der die Dateien in den Daten für die Aktion angegeben sind (siehe folgende Abbildung).

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