> Source: https://docs.cyberelements.io/bastion/4.6/da/Usage/AdminConsoleReference/RDSServers/

# RDS servers

Modulet **RDS servers** registrerer i Bastion de Windows Remote Desktop Services-servere, der skal hoste de publicerede applikationer eller fjernskriveborde. Fra denne skærm kan administratoren finde servere i et katalog, registrere dem, udrulle eller fjerne Bastion-agenten på dem og oprette applikationer i massevis, der peger på disse servere.

De applikationer, der udstiller disse servere for brugerne, erklæres i modulet [Applications](https://docs.cyberelements.io/bastion/4.6/da/Usage/AdminConsoleReference/Applications/) og gøres tilgængelige gennem en [access contract](https://docs.cyberelements.io/bastion/4.6/da/Usage/AdminConsoleReference/AccessContracts/).

> **Forudsætning: domænet skal tillade administration af RDS-servere**
>
> Kun autentifikationsdomæner af typen **LDAP / Active Directory**, hvor indstillingen **Allow RDS server management** er markeret, vises på denne skærm — det er den indstilling, der gør et domæne kvalificeret, og den markeres i modulet [Authentication domain](https://docs.cyberelements.io/bastion/4.6/da/Usage/AdminConsoleReference/AuthenticationDomain/). De øvrige domænetyper (lokalt katalog, SAML, anonym) listes aldrig, uanset deres konfiguration.

---

## Serverliste

Hovedskærmen viser den paginerede liste over de RDS-servere, der allerede er registreret.

### Filtre og søgning

| Element | Beskrivelse |
|---|---|
| **Domain** | Rulleliste med de kvalificerede LDAP-domæner. En samlende post **All** tilføjes øverst for at vise alle servere uanset domæne. |
| **Søgefelt** | Filtrerer de opførte servere efter delstreng. Søgningen udløses 700 ms efter det sidste tastetryk eller straks med `Enter`. Sletteudløseren (krydset) nulstiller søgningen. |
| **Paginering** | Vælger for sidestørrelse (`15`, `25` eller `50`). |
| **Tabellens kolonner** | **Name**, **Host**, **LDAP domain**. |

Tabellen understøtter multivalg. Så længe ingen server returneres, vises en meddelelse om den tomme tilstand.

### Handlinger i værktøjslinjen

Knapperne i værktøjsbjælken er kontekstafhængige: de, der virker på eksisterende servere, forbliver deaktiverede, indtil mindst én række er valgt.

| Handling | Tilgængelighed | Virkning |
|---|---|---|
| **+** — værktøjstip **Register RDS servers** | Altid tilgængelig | Åbner registreringsvinduet med tre faner (se kapitel [Registrer en eller flere servere](#register-one-or-several-servers)). |
| **×** (Slet) | Valg ≥ 1 | Åbner bekræftelsesvinduet (se kapitel [Slet en server](#delete-a-server)). |
| **Deploy Agent** | Valg ≥ 1 | Åbner formularen til at udrulle Bastion-agenten på de valgte servere (se kapitel [Deploy Agent (direkte handling)](#deploy-agent-direct-action)). |
| **Remove Agent** | Valg ≥ 1 | Åbner formularen til at afinstallere Bastion-agenten fra de valgte servere (se kapitel [Fjernelse af agenten](#agent-removal)). |
| **New applications** | Valg ≥ 1 | Åbner formularen til masseoprettelse af en applikation, der oprettes for hver valgt server (se kapitel [Masseoprettelse af applikationer](#bulk-application-creation)). |

---

## Registrer en eller flere servere

Knappen **+** åbner et modalt vindue med **tre faner**. Fanen **Server registration** er altid aktiv. De to andre bliver kun aktive, hvis valget af mindst én server gør dem relevante.

**Server registration**

> Fanen viser to paneler side om side. Til venstre findes de servere, der er tilgængelige i kataloget; til højre listen over de servere, der er udvalgt til denne registrering.
>
> | Element | Beskrivelse |
> |---|---|
> | **Domain** | Mål-LDAP-domænet. Begrænser den venstre liste til dette domænes servere. |
> | **Søgefelt** | Filter efter delstreng. Udløses efter 1200 ms uden aktivitet eller med `Enter`. |
> | **Venstre liste** | RDS-servere, der er fundet i domænet (navn, domæne, DNS). Servere, der allerede er registreret, udelukkes automatisk. Knapperne **Select all** og **Refresh** er tilgængelige nederst. |
> | **Højre liste** | Servere, der er valgt til denne registrering. Drag and drop fra den venstre liste tilføjer servere; hver flise kan fjernes enkeltvis med sit lukkekryds. |
> | **Tæller** | Viser antallet af valgte servere i forhold til det tilladte maksimum, i formen ***n* / 200 RDS servers**. |
>
> For hver server, der tilføjes til højre, tilbydes to afkrydsningsfelter:
>
> | Afkrydsningsfelt | Virkning |
> |---|---|
> | **Deploy an agent** | Markerer denne server til udrulning af Bastion-agenten i samme handling. Aktiverer fanen **Agent deployment**. |
> | **Create applications** | Markerer denne server til oprettelse af de applikationer, der er defineret i fanen **New applications**. Aktiverer denne fane. |
>
> To knapper **Deploy an agent** og **Create applications**, placeret over fliserne, markerer eller fjerner markeringen i det tilsvarende afkrydsningsfelt på **alle** valgte servere på én gang.
>
> > **Grænse for valget**
> >
> > Højst **200 servere** kan behandles i en enkelt registreringshandling. Ethvert forsøg på at tilføje servere ud over denne grænse afvises med en advarselsmeddelelse.
>
> > **Domæner, der ikke kan nås**
> >
> > Svarer et af de forespurgte domæner ikke, opremser en fejlmeddelelse de domæner, der fejlede, og antallet af udførte forsøg (`Error` ved en øjeblikkelig fejl, `5 retries` efter fem forsøg). Serverne fra de domæner, der kan nås, vises alligevel.

**Agent deployment**

> Fanen er kun aktiv, hvis afkrydsningsfeltet **Agent deployment** er markeret ved mindst én server i den højre liste. Alle felter er obligatoriske.
>
> | Felt | Beskrivelse |
> |---|---|
> | **Target Server** | Den server, agenten skal skubbes ud til. **Skjult og deaktiveret i flerserver-tilstand**: målet beregnes da ud fra de valgte servere. |
> | **Target drive** | Bogstav for det drev, agenten skal installeres på. |
> | **Target directory** | Agentens installationssti på serveren. Tegnene `"` og `'` afvises ved indtastningen. |
> | **Gateway** | Den Edge Gateway i Bastion, der styrer udrulningen. |
> | **Domain** | Installationskontoens autentificeringsdomæne. |
> | **Username** | Konto, der har tilladelse til at installere software på målserveren. |
> | **Password** | Installationskontoens adgangskode (maskeret). |

**New applications**

> Fanen er kun aktiv, hvis afkrydsningsfeltet **New applications** er markeret ved mindst én server i den højre liste.
>
> Fanen viser en tabel med **applikationsskabeloner**, der skal oprettes på hver valgt server. Tre handlinger:
>
> | Knap | Virkning |
> |---|---|
> | **+** — værktøjstip **New application template** | Åbner formularen til at tilføje en applikation i gruppetilstand. Kun tjenestetyperne **RDP** og **HTML5 RDP** tilbydes. |
> | **Edit** | Aktiv, når præcis én række er valgt. |
> | **×** | Fjerner de valgte skabeloner. |
>
> Tabellens kolonner:
>
> | Kolonne | Indhold |
> |---|---|
> | **Name** | Skabelonens navn, med ikonet for tjenestetypen foran. |
> | **Recording** | Visuel markering af muligheden for videooptagelse. |
> | **SSO / Remote application / Working directory** | Sammendrag af den valgte SSO-tilstand (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), af det valgfrie alias, af navnet på fjernapplikationen (RemoteApp) og af startmappen. |
>
> Skabelonnavne skal være **unikke** i listen: en dublet afvises med en advarsel.
>
> > **Variabilisering af skabelonnavnet**
> >
> > For at generere et forskelligt navn pr. server skal du bruge tegnene `{` og `}` i skabelonens felt **Name**. Uden krøllede parenteser føjes servernavnet til slutningen af skabelonnavnet. Med krøllede parenteser erstatter det `{}`.
> >
> > - Skabelonen `Application RDP` anvendt på serveren `srv1` → `Application RDP srv1`
> > - Skabelonen `Application {} RDP` anvendt på serveren `srv1` → `Application srv1 RDP`

### Validering og rapport

Knappen **Validate** er kun aktiv, hvis:

- mindst én server står i den højre liste,
- fanen **Agent deployment** er gyldig (når det er påkrævet),
- fanen **New applications** indeholder mindst én skabelon (når det er påkrævet).

Ved indsendelsen åbnes et **rapport**-vindue med en fane pr. handling (registrering, udrulning af agenten, oprettelse af applikationer). Hver række får undervejs en status: *i gang*, *lykkedes*, *generel fejl*, *adgang nægtet*, *agent allerede til stede* eller *ukendt status (intet svar)*. Knappen **Close** bliver først aktiv, når alle handlinger er afsluttet.

> **Opfølgning på installationen af agenten**
>
> Installationen af agenten er asynkron, så rapporten forespørger serveren hvert 5. sekund for at opdatere statussen, så længe opgaven er markeret `INPROGRESS`.

---

## Deploy Agent (direkte handling)

Knappen **Deploy Agent** i værktøjsbjælken åbner udrulningsformularen direkte, forudfyldt med de servere, der er valgt i hovedlisten — feltet **Target Server** indeholder da deres navne, adskilt af kommaer.

Felterne er dem fra fanen **Agent deployment** i kapitel [Registrer en eller flere servere](#register-one-or-several-servers), med én forskel: **Target Server** er der synlig og redigerbar, da flerserver-tilstanden ikke gælder. Alle felter er obligatoriske.

Ved indsendelsen låses hovedtabellen, mens handlingen kører, og en periodisk forespørgsel (hvert 5. sekund) opdaterer installationsstatussen indtil afslutningen.

---

## Fjernelse af agenten

Knappen **Remove Agent** i værktøjsbjælken åbner formularen til at afinstallere agenten på de valgte servere.

| Felt | Beskrivelse |
|---|---|
| **Target Server** | De berørte servere, forudfyldt og adskilt af kommaer. |
| **Gateway** | Den Edge Gateway i Bastion, der bruges til at styre afinstallationen. |
| **Domain** | Administrationskontoens autentificeringsdomæne. |
| **Username** | Konto, der har tilladelse til at afinstallere agenten på serveren. |
| **Password** | Kontoens adgangskode (maskeret). |

Alle felter er obligatoriske.

---

## Slet en server

Knappen **×** i værktøjsbjælken åbner et bekræftelsesvindue. Den indledende tekst tilpasses valget (en enkelt server eller flere servere).

Der tilbydes to uafhængige muligheder:

| Mulighed | Virkning |
|---|---|
| **Delete Bastion agents** | Hvis feltet er markeret, udføres afinstallationsproceduren på de berørte servere på tidspunktet for sletningen. Afinstallationsvinduet (kapitel [Fjernelse af agenten](#agent-removal)) kobles derefter på for at indsamle adgangsparametrene. |
| **Delete related applications** | Er den markeret, slettes de applikationer, der er målrettet disse servere, samtidig. |

Ved indsendelsen opsummerer et rapportvindue resultatet af hver handling.

> **Sletning uden fjernelse af agenten**
>
> Hvis afkrydsningsfeltet til afinstallation ikke er markeret, fjernes serverens post fra Bastion, men agenten forbliver installeret på maskinen. Den skal afinstalleres manuelt eller via en ny **Remove Agent**-handling.

---

## Masseoprettelse af applikationer

Knappen **New applications** i værktøjsbjælken åbner formularen til gruppevis tilføjelse af applikationer, uden et forudgående registreringstrin. Formularen er den fra modulet **Applications**, begrænset til tjenestetyperne **RDP** og **HTML5 RDP**.

Ved indsendelsen oprettes applikationen på hver server, der er valgt i hovedlisten, ved at anvende mekanismen til variabilisering af navne, som er beskrevet i kapitel [Registrer en eller flere servere](#register-one-or-several-servers) (brug af `{}` til at indsætte servernavnet). Rapportvinduet viser resultatet række for række.
