Sincronizador personalizado (PowerShell)

Esta entrada es un potente sincronizador "híbrido" que le permite usar scripts de PowerShell para rellenar bóvedas, sincronizar descripciones, aplicar plantillas y más. Puede sincronizar desde orígenes para los que no tenemos un sincronizador dedicado. Aprovecha clases proxy para interactuar con los completos objetos de conexión de Remote Desktop Manager.

Consulte Comandos de PowerShell para ver una lista de los comandos PS personalizados de Devolutions, con descripciones, ejemplos y parámetros comunes admitidos.

Casos de uso del sincronizador Custom (PowerShell)

Sesión simple

Proporcione el host, el nombre, la descripción y el grupo utilizando el tipo RDP predeterminado. Como alternativa, utilice una plantilla para fomentar la reutilización y la estandarización. Aquí tiene un ejemplo:

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

Sesión con credenciales

Para establecer las credenciales, utilice: $session.SetCredentials($row.Username, $row.Password, $row.Domain);.

Para establecer únicamente la contraseña, utilice: $session.SetPassword($row.Password);.

La contraseña no se puede establecer mediante $session.Password.

Campos de uso habitual

Estos son los campos de uso habitual, como referencia rápida:

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

Escenario avanzado

Utilizando el método descrito en Ingeniería inversa de la estructura de una entrada, puede crear una entrada con toda la información necesaria en los campos adecuados y observar cómo asignar valores mediante PowerShell. Por ejemplo, aquí tiene una entrada Host en la que se han rellenado muchos campos de la sección 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>

Puede ver algunos objetos "complejos", concretamente HostDetails y MetaInformation. El primero es específico del tipo de entrada Host, y el segundo es un contenedor para todo lo que hay en la sección View – Asset. Añada el nombre de la sección como prefijo para escribir en los campos internos.

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

Puntos clave

• Tenga en cuenta que las propiedades Name y HostDetails.Host comparten el mismo valor. Esta es una característica de la entrada Host, y también debe tenerse precaución al trabajar con otros tipos de entrada.
• Algunos campos, como MetaInformation.AssetSubType, están vinculados a una enumeración y deben contener la cadena exacta. Otros, como MetaInformation.NetworkGateway, son simples cadenas y pueden contener cualquier valor. No dude en contactar con nuestro equipo de soporte si tiene más preguntas.

Temas relacionados

• Sincronizadores
• Lista de nombres de propiedades para scripts de PowerShell
• Comandos de PowerShell