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

# RDS servers

Modulen **RDS servers** registrerar i Bastion de Windows Remote Desktop Services-servrar som ska hosta publicerade applikationer eller fjärrskrivbord. Från denna skärm kan administratören upptäcka servrar i en katalog, registrera dem, rulla ut eller ta bort Bastion-agenten på dem och massskapa applikationer som pekar mot dessa servrar.

De applikationer som exponerar dessa servrar för användarna deklareras i modulen [Applications](https://docs.cyberelements.io/bastion/4.6/sv/Usage/AdminConsoleReference/Applications/) och görs tillgängliga via ett [access contract](https://docs.cyberelements.io/bastion/4.6/sv/Usage/AdminConsoleReference/AccessContracts/).

> **Förutsättning: domänen måste tillåta hantering av RDS-servrar**
>
> Endast autentiseringsdomäner av typen **LDAP / Active Directory** där alternativet **Allow RDS server management** är markerat visas på denna skärm — det är detta alternativ som gör en domän valbar, och det markeras i modulen [Authentication domain](https://docs.cyberelements.io/bastion/4.6/sv/Usage/AdminConsoleReference/AuthenticationDomain/). Övriga domäntyper (lokal katalog, SAML, anonym) listas aldrig, oavsett konfiguration.

---

## Serverlista

Huvudskärmen visar den paginerade listan över redan registrerade RDS-servrar.

### Filter och sökning

| Element | Beskrivning |
|---|---|
| **Domain** | Rullgardinsmeny med valbara LDAP-domäner. En sammanfattande post **All** läggs till högst upp för att visa samtliga servrar, oavsett domän. |
| **Sökfält** | Filtrerar de listade servrarna på delsträng. Sökningen utlöses 700 ms efter den senaste tangenttryckningen, eller omedelbart med `Enter`. Rensningsknappen (krysset) återställer sökningen. |
| **Pagination** | Väljare för sidstorlek (`15`, `25` eller `50`). |
| **Tabellens kolumner** | **Name**, **Host**, **LDAP domain**. |

Tabellen stöder flerval. Så länge ingen server returneras visas ett meddelande om tomt läge.

### Åtgärder i verktygsfältet

Knapparna i verktygsfältet är kontextberoende: de som verkar på befintliga servrar förblir inaktiverade tills minst en rad är markerad.

| Åtgärd | Tillgänglighet | Effekt |
|---|---|---|
| **+** — verktygstips **Register RDS servers** | Alltid tillgänglig | Öppnar registreringsfönstret med tre flikar (se kapitel [Registrera en eller flera servrar](#register-one-or-several-servers)). |
| **×** (Ta bort) | Markering ≥ 1 | Öppnar bekräftelsefönstret (se kapitel [Ta bort en server](#delete-a-server)). |
| **Deploy Agent** | Val ≥ 1 | Öppnar formuläret för att rulla ut Bastion-agenten på de valda servrarna (se kapitlet [Deploy Agent (direkt åtgärd)](#deploy-agent-direct-action)). |
| **Remove Agent** | Val ≥ 1 | Öppnar formuläret för att avinstallera Bastion-agenten från de valda servrarna (se kapitlet [Ta bort agenten](#agent-removal)). |
| **New applications** | Markering ≥ 1 | Öppnar formuläret för att skapa en applikation i grupp, replikerad för varje vald server (se kapitel [Skapa applikationer i grupp](#bulk-application-creation)). |

---

## Registrera en eller flera servrar

Knappen **+** öppnar ett modalt fönster med **tre flikar**. Fliken **Server registration** är alltid aktiv. De två övriga blir aktiva endast om valet av minst en server gör dem relevanta.

**Server registration**

> Fliken visar två paneler sida vid sida. Till vänster upptäckt av de servrar som är tillgängliga i katalogen; till höger listan över de servrar som valts för denna registrering.
>
> | Element | Beskrivning |
> |---|---|
> | **Domain** | LDAP-måldomän. Begränsar den vänstra listan till servrarna i den domänen. |
> | **Sökfält** | Filter på delsträng. Utlöses efter 1200 ms utan aktivitet eller med `Enter`. |
> | **Vänstra listan** | RDS-servrar som hittats i domänen (namn, domän, DNS). Servrar som redan är registrerade utesluts automatiskt. Knapparna **Select all** och **Refresh** finns i nedre delen. |
> | **Högra listan** | Servrar som valts för denna registrering. Dra och släpp från den vänstra listan lägger till servrar; varje kort kan tas bort enskilt med sitt stängningskryss. |
> | **Räknare** | Visar antalet valda servrar mot det högsta tillåtna antalet, som ***n* / 200 RDS servers**. |
>
> För varje server som lagts till till höger erbjuds två kryssrutor:
>
> | Kryssruta | Effekt |
> |---|---|
> | **Deploy an agent** | Markerar denna server för utrullning av Bastion-agenten i samma åtgärd. Aktiverar fliken **Agent deployment**. |
> | **Create applications** | Markerar denna server för skapande av de applikationer som definieras i fliken **New applications**. Aktiverar den fliken. |
>
> Två knappar **Deploy an agent** och **Create applications**, placerade ovanför korten, markerar eller avmarkerar motsvarande kryssruta på **samtliga** valda servrar i ett svep.
>
> > **Gräns för valet**
> >
> > Högst **200 servrar** kan behandlas i en enda registreringsåtgärd. Varje försök att lägga till servrar över den gränsen avvisas med ett varningsmeddelande.
>
> > **Domäner som inte kan nås**
> >
> > Om någon av de tillfrågade domänerna inte svarar listar ett felmeddelande de domäner som misslyckats och antalet utförda försök (`Error` vid ett omedelbart fel, `5 retries` efter fem försök). Servrarna i de domäner som kan nås visas ändå.

**Agent deployment**

> Flik som är aktiv endast om minst en server i den högra listan har kryssrutan **Agent deployment** markerad. Alla fält är obligatoriska.
>
> | Fält | Beskrivning |
> |---|---|
> | **Target Server** | Server som agenten ska installeras på. **Dold och inaktiverad i flerserverläge**: målet beräknas då utifrån de valda servrarna. |
> | **Target drive** | Bokstav för den enhet som agenten ska installeras på. |
> | **Target directory** | Agentens installationssökväg på servern. Tecknen `"` och `'` avvisas vid inmatning. |
> | **Gateway** | Edge Gateway i Bastion som styr utrullningen. |
> | **Domain** | Installationskontots autentiseringsdomän. |
> | **Username** | Konto som får installera programvara på målservern. |
> | **Password** | Installationskontots lösenord (maskerat). |

**New applications**

> Flik som är aktiv endast om minst en server i den högra listan har kryssrutan **New applications** markerad.
>
> Fliken visar en tabell med **applikationsmallar** som ska skapas på varje vald server. Tre åtgärder:
>
> | Knapp | Effekt |
> |---|---|
> | **+** — verktygstips **New application template** | Öppnar formuläret för att lägga till en applikation i gruppläge. Endast tjänstetyperna **RDP** och **HTML5 RDP** erbjuds. |
> | **Edit** | Aktiv när exakt en rad är markerad. |
> | **×** | Tar bort de valda mallarna. |
>
> Tabellens kolumner:
>
> | Kolumn | Innehåll |
> |---|---|
> | **Name** | Mallens namn, föregånget av tjänstetypens ikon. |
> | **Recording** | Visuell markering av alternativet för videoinspelning. |
> | **SSO / Remote application / Working directory** | Sammanfattning av valt SSO-läge (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), av det valfria aliaset, av fjärrapplikationens namn (RemoteApp) och av startkatalogen. |
>
> Mallnamn måste vara **unika** i listan: en dubblett avvisas med en varning.
>
> > **Variabilisering av mallnamnet**
> >
> > För att generera ett olika namn per server, använd tecknen `{` och `}` i mallens fält **Name**. Utan klamrar läggs servernamnet till i slutet av mallnamnet. Med klamrar ersätter det `{}`.
> >
> > - Mallen `Application RDP` tillämpad på servern `srv1` → `Application RDP srv1`
> > - Mallen `Application {} RDP` tillämpad på servern `srv1` → `Application srv1 RDP`

### Validering och rapport

Knappen **Validate** är aktiv endast om:

- minst en server finns i den högra listan,
- fliken **Agent deployment** är giltig (när det krävs),
- fliken **New applications** innehåller minst en mall (när det krävs).

Vid inskickning öppnas ett **rapportfönster**, med en flik per åtgärd (registrering, distribution av agenten, skapande av applikationer). Varje rad får en status medan arbetet fortskrider: *pågår*, *lyckades*, *allmänt fel*, *åtkomst nekad*, *agenten finns redan* eller *okänd status (inget svar)*. Knappen **Close** blir aktiv först när alla åtgärder har slutförts.

> **Uppföljning av agentinstallationen**
>
> Installationen av agenten är asynkron, så rapporten frågar servern var 5:e sekund för att uppdatera statusen så länge uppgiften är märkt `INPROGRESS`.

---

## Deploy Agent (direktåtgärd)

Knappen **Deploy Agent** i verktygsfältet öppnar utrullningsformuläret direkt, förifyllt med de servrar som valts i huvudlistan — fältet **Target Server** innehåller då deras namn, kommaseparerade.

Fälten är de i fliken **Agent deployment** i kapitel [Registrera en eller flera servrar](#register-one-or-several-servers), med en skillnad: **Target Server** är där synligt och redigerbart, eftersom flerserverläget inte gäller. Alla fält är obligatoriska.

Vid inskickning låses huvudtabellen medan åtgärden pågår, och en periodisk avfrågning (var 5:e sekund) uppdaterar installationsstatusen fram till dess att den är klar.

---

## Ta bort agenten

Knappen **Remove Agent** i verktygsfältet öppnar formuläret för att avinstallera agenten på de valda servrarna.

| Fält | Beskrivning |
|---|---|
| **Target Server** | Berörda servrar, förifyllda och kommaseparerade. |
| **Gateway** | Edge Gateway i Bastion som används för att styra avinstallationen. |
| **Domain** | Administrationskontots autentiseringsdomän. |
| **Username** | Konto som får avinstallera agenten på servern. |
| **Password** | Kontots lösenord (maskerat). |

Alla fält är obligatoriska.

---

## Ta bort en server

Knappen **×** i verktygsfältet öppnar ett bekräftelsefönster. Inledningstexten anpassas till markeringen (en enda server eller flera servrar).

Två oberoende alternativ erbjuds:

| Alternativ | Effekt |
|---|---|
| **Delete Bastion agents** | Om detta är markerat körs avinstallationsförfarandet mot de berörda servrarna vid borttagningen. Avinstallationsfönstret (kapitlet [Ta bort agenten](#agent-removal)) kopplas då in för att samla in åtkomstparametrarna. |
| **Delete related applications** | Om alternativet är markerat tas de applikationer som riktar sig mot dessa servrar bort samtidigt. |

Vid inskickning sammanfattar ett rapportfönster utfallet av varje åtgärd.

> **Ta bort utan att avinstallera agenten**
>
> Om kryssrutan för avinstallation inte är markerad tas serverposten bort från Bastion, men agenten förblir installerad på maskinen. Den måste avinstalleras manuellt eller via en ny åtgärd **Remove Agent**.

---

## Skapa applikationer i grupp

Knappen **New applications** i verktygsfältet öppnar formuläret för grupperat tillägg av applikationer, utan något föregående registreringssteg. Formuläret är det i modulen **Applications**, begränsat till tjänstetyperna **RDP** och **HTML5 RDP**.

Vid inskickning skapas applikationen på varje server som valts i huvudlistan, med tillämpning av den mekanism för variabilisering av namn som beskrivs i kapitel [Registrera en eller flera servrar](#register-one-or-several-servers) (användning av `{}` för att infoga servernamnet). Rapportfönstret visar resultatet rad för rad.
