Erstellung von und Umgang mit ADS-Routen

Das Hinzufügen von ADS-Routen über das Automation Interface kann mit Hilfe der ConsumeXml()-Methode der ITcSmTreeItem-Schnittstelle erledigt werden. Allerdings sollte man mit der zugrunde liegenden XML-Struktur vertraut sein, bevor man Routen zu einem entfernten Zielgerät hinzufügt.

XML-Struktur

Der folgende Code-Ausschnitt stellt ein Beispiel für XML-Strukturen für das Hinzufügen von Routen zu einem entfernten Zielgerät dar. Beachten Sie, dass Sie entweder die IP-Adresse oder den Hostnamen des entfernten Zielgeräts angeben können.

Dieser Code-Ausschnitt fügt eine reguläre Route zu einem entfernten Zielgerät hinzu.

Code-Ausschnitt (XML):

<TreeItem>
  <ItemName>Route Settings</ItemName>
  <PathName>TIRR</PathName>
  <RoutePrj>
    <TargetList>
      <BroadcastSearch>true</BroadcastSearch>
    </TargetList>
    <AddRoute>
      <RemoteName>RouteName</RemoteName>
      <RemoteNetId>1.2.3.4.5.6</RemoteNetId>
      <RemoteIpAddr>1.2.3.4</RemoteIpAddr>
      <UserName>userName</UserName>
      <Password>password</Password>
      <NoEncryption></NoEncryption>
      <LocalName>LocalName</LocalName>
    </AddRoute>
  </RoutePrj>
</TreeItem>

Dieser Code-Ausschnitt fügt eine Projektroute zu einem entfernten Zielgerät hinzu.

Code-Ausschnitt (XML):

<TreeItem>
  <ItemName>Route Settings</ItemName>
  <PathName>TIRR</PathName>
  <RoutePrj>
    <TargetList>
      <BroadcastSearch>true</BroadcastSearch>
    </TargetList>
    <AddProjectRoute>
      <Name>RouteName</Name>
      <NetId>1.2.3.4.5.6</NetId>
      <IpAddr>1.2.3.4</IpAddr>
    </AddProjectRoute>
  </RoutePrj>
</TreeItem>

Der folgende Code-Ausschnitt verwendet den Hostnamen anstatt der IP-Adresse.

Code-Ausschnitt (XML):

<TreeItem>
  <ItemName>Route Settings</ItemName>
  <PathName>TIRR</PathName>
  <RoutePrj>
    <TargetList>
      <BroadcastSearch>true</BroadcastSearch>
    </TargetList>
    <AddRoute>
      <RemoteName>RouteName</RemoteName>
      <RemoteNetId>1.2.3.4.5.6</RemoteNetId>
      <RemoteHostName>CX-12345</RemoteHostName>
      <UserName>userName</UserName>
      <Password>password</Password>
      <NoEncryption></NoEncryption>
      <LocalName>LocalName</LocalName>
    </AddRoute>
  </RoutePrj>
</TreeItem>

Und für Projektrouten.

Code-Ausschnitt (XML):

<TreeItem>
  <ItemName>Route Settings</ItemName>
  <PathName>TIRR</PathName>
  <RoutePrj>
    <TargetList>
      <BroadcastSearch>true</BroadcastSearch>
    </TargetList>
    <AddProjectRoute>
      <Name>RouteName</Name>
      <NetId>1.2.3.4.5.6</NetId>
      <HostName>1.2.3.4</HostName>
    </AddProjectRoute>
  </RoutePrj>
</TreeItem>

Denken Sie daran, dass die XML-Struktur für reguläre und Projektrouten gleichzeitig benutzt werden kann.

Der folgende Code-Ausschnitt erstellt eine ADS-Route zu einem entfernten Gerät, das durch seine IP-Adresse (10.1.128.217) und AMS NetId (10.1.128.217.1.1) spezifiziert wurde.

Code-Ausschnitt (C#):

          string xmlString ="<TreeItem><ItemName>Route Settings</ItemName><PathName>TIRR</PathName><RoutePrj><TargetList><BroadcastSearch>true</BroadcastSearch></TargetList><AddRoute><RemoteName>RouteName</RemoteName><RemoteNetId>10.1.128.217.1.1</RemoteNetId><RemoteIpAddr>10.1.128.217</RemoteIpAddr><UserName>Administrator</UserName><Password>1</Password><NoEncryption></NoEncryption></AddRoute></RoutePrj></TreeItem>";
ITcSmTreeItem routes = systemManager.LookupTreeItem("TIRR");
routes.ConsumeXml(xmlString);

Code-Ausschnitt (Powershell):

          $xmlString ="<TreeItem><ItemName>Route Settings</ItemName><PathName>TIRR</PathName><RoutePrj><TargetList><BroadcastSearch>true</BroadcastSearch></TargetList><AddRoute><RemoteName>RouteName</RemoteName><RemoteNetId>10.1.128.217.1.1</RemoteNetId><RemoteIpAddr>10.1.128.217</RemoteIpAddr><UserName>Administrator</UserName><Password>1</Password><NoEncryption></NoEncryption></AddRoute></RoutePrj></TreeItem>"
$routes = $systemManager.LookupTreeItem("TIRR")
$routes.ConsumeXml($xmlString)