Benutzerdefinierter (PowerShell) Synchronizer

Dieser Eintrag ist ein leistungsstarker "hybrider" Synchronizer, mit dem Sie PowerShell-Skripte verwenden können, um Tresore zu füllen, Beschreibungen zu synchronisieren, Vorlagen anzuwenden und mehr. Sie können von Quellen synchronisieren, für die wir keinen dedizierten Synchronizer haben. Er nutzt Proxy-Klassen, um mit umfangreichen Remote Desktop Manager-Verbindungsobjekten zu interagieren.

Siehe PowerShell commands für eine Liste der benutzerdefinierten PS-Befehle von Devolutions, komplett mit Beschreibungen, Beispielen und unterstützten allgemeinen Parametern.

Anwendungsfälle für den Custom (PowerShell)-Synchronizer

Einfache Sitzung

Geben Sie den Host, den Namen, die Beschreibung und die Gruppe an, während Sie den standardmäßigen RDP-Typ verwenden. Alternativ können Sie eine Vorlage verwenden, um Wiederverwendung und Standardisierung zu fördern. Hier ist ein Beispiel:

# Obtain or generate your list of sessions to create, here we assume a $data table.
# Has been filled by querying an external source.
Foreach($row in $data)
{
  # Create a new session, the only mandatory property is 'Name' so we require it as a parameter in the Add method.
  $session = $RDM.Add($row.Name)
  # Set the other properties using $session.
  $session.Host = $row.Name
  $session.Description = $row.Description
  $session.Group = $row.Group # it can be multiple levels i.e. 'Folder1\Folder1a'
}

Sitzung mit Anmeldeinformationen

Um die Anmeldeinformationen festzulegen, verwenden Sie: $session.SetCredentials($row.Username, $row.Password, $row.Domain);.

Um nur das Passwort festzulegen, verwenden Sie: $session.SetPassword($row.Password);.

Das Passwort kann nicht mit $session.Password festgelegt werden.

Häufig verwendete Felder

Hier sind häufig verwendete Felder als Kurzreferenz:

string CustomStatus
string Description
bool Encrypt
string Group
string Host
bool IncludeInFavorite
string Name
bool OpenEmbedded
bool ShowInTrayIcon
int SortPriority
<Color>#FF0000</Color>
string GroupTab
string Status
string TabTitle

Fortgeschrittenes Szenario

Mit der in Reverse engineering an entry's structure beschriebenen Methode können Sie einen Eintrag mit allen erforderlichen Informationen in den entsprechenden Feldern erstellen und beobachten, wie Werte mit PowerShell zugewiesen werden. Hier ist zum Beispiel ein Host-Eintrag, für den viele Felder des Abschnitts View – Asset ausgefüllt wurden:

<?xml version="1.0" encoding="utf-8"?>
<ArrayOfConnection>
  <Connection>
    <AppVersion>~SET AUTOMATICALLY~</AppVersion>
    <Color>#FF0000</Color>
    <ConnectionType>Host</ConnectionType>
    <CreatedBy>~SET AUTOMATICALLY~</CreatedBy>
    <CreationDateTime>~SET AUTOMATICALLY~</CreationDateTime>
    <Description>phDescription</Description>
    <GroupTab>phTabGroupName</GroupTab>
    <ID>~SET AUTOMATICALLY~</ID>
    <Name>phName</Name>
    <OpenEmbedded>true</OpenEmbedded>
    <SortPriority>100</SortPriority>
    <Status>{123A44CB-7EDC-4ecb-926B-031793668148}</Status>
    <TabTitle>phTabPageTitle</TabTitle>
    <HostDetails>
      <Host>phName</Host>
    </HostDetails>
    <MetaInformation>
      <AssetSubType>Desktop</AssetSubType>
      <Domain>metadomain</Domain>
      <IP>metaIP</IP>
      <Keywords>MyTag1</Keywords>
      <MAC>metamac</MAC>
      <MachineName>metaHost</MachineName>
      <NetworkDHCPRange>MetaDHCPRange</NetworkDHCPRange>
      <NetworkDHCPServer>MetaDHCPServer</NetworkDHCPServer>
      <NetworkFirewallZone>MetaFirewall</NetworkFirewallZone>
      <NetworkGateway>MetaGateway</NetworkGateway>
      <NetworkIPRange>metaIPRange</NetworkIPRange>
      <NetworkSubnet>metaSubnet</NetworkSubnet>
      <NetworkVLANID>MetaVlan</NetworkVLANID>
      <OS>metaos</OS>
    </MetaInformation>
  </Connection>
</ArrayOfConnection>

Sie können einige "komplexe" Objekte sehen, nämlich HostDetails und MetaInformation. Das erste ist spezifisch für den Eintragstyp Host, und das zweite ist ein Container für alles im Abschnitt View – Asset. Fügen Sie den Abschnittsnamen als Präfix hinzu, um in die inneren Felder zu schreiben.

Foreach($row in $data)
{
  $session = $RDM.Add($row.Name)
  $session.Kind = "Host"
  $session.HostDetails.Host = $row.Name
  $session.MetaInformation.AssetSubType = "Desktop"
  $session.MetaInformation.IP = "10.10.1.25"
}

Wichtige Punkte

• Beachten Sie, dass die Eigenschaften Name und HostDetails.Host denselben Wert haben. Dies ist eine Eigenschaft des Host-Eintrags, und es ist auch bei der Arbeit mit anderen Eintragstypen Vorsicht geboten.
• Einige Felder, wie MetaInformation.AssetSubType, sind an eine Aufzählung gebunden und müssen die exakte Zeichenfolge enthalten. Andere, wie MetaInformation.NetworkGateway, sind einfache Zeichenfolgen und können beliebige Inhalte enthalten. Kontaktieren Sie gerne unser Support-Team, wenn Sie weitere Fragen haben.

Verwandte Themen

• Synchronizers
• List of property names for PowerShell script
• PowerShell commands