Sincronizzatore personalizzato (PowerShell)

Questa voce è un potente sincronizzatore "ibrido" che le consente di utilizzare script PowerShell per popolare le casseforti, sincronizzare le descrizioni, applicare modelli e altro ancora. Può sincronizzare da origini per le quali non disponiamo di un sincronizzatore dedicato. Sfrutta le classi proxy per interagire con i ricchi oggetti di connessione di Remote Desktop Manager.

Consulti PowerShell commands per un elenco dei comandi PS personalizzati di Devolutions, completo di descrizioni, esempi e parametri comuni supportati.

Casi d'uso del sincronizzatore Custom (PowerShell)

Sessione semplice

Fornisca l'host, il nome, la descrizione e il gruppo utilizzando il tipo RDP predefinito. In alternativa, utilizzi un modello per favorire il riutilizzo e la standardizzazione. Ecco un esempio:

# 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'
}

Sessione con credenziali

Per impostare le credenziali, utilizzi: $session.SetCredentials($row.Username, $row.Password, $row.Domain);.

Per impostare solo la password, utilizzi: $session.SetPassword($row.Password);.

La password non può essere impostata utilizzando $session.Password.

Campi di uso comune

Ecco i campi di uso comune per una rapida consultazione:

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

Scenario avanzato

Utilizzando il metodo descritto in Reverse engineering an entry's structure, può creare una voce con tutte le informazioni necessarie nei campi appropriati e osservare come assegnare i valori tramite PowerShell. Ad esempio, ecco una voce Host per la quale sono stati compilati molti campi della sezione View – Asset:

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

Può notare alcuni oggetti "complessi", ovvero HostDetails e MetaInformation. Il primo è specifico del tipo di voce Host, mentre il secondo è un contenitore per tutto ciò che si trova nella sezione View – Asset. Aggiunga il nome della sezione come prefisso per scrivere nei campi interni.

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

Punti chiave

• Noti che le proprietà Name e HostDetails.Host condividono lo stesso valore. Questa è una caratteristica della voce Host, e occorre prestare attenzione anche quando si lavora con altri tipi di voce.
• Alcuni campi, come MetaInformation.AssetSubType, sono legati a un'enumerazione e devono contenere la stringa esatta. Altri, come MetaInformation.NetworkGateway, sono semplici stringhe e possono contenere qualsiasi valore. Non esiti a contattare il nostro team di supporto in caso di ulteriori domande.

Argomenti correlati

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