---
title: "ay rdp"
source: "https://ayoune.com/en/docs/cli/rdp"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "en"
retrieved: "2026-08-27T22:22:53.948Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay rdp` (Alias: `remote`)

Verbindet zu einem Computing Entity (CE) via RDP. Lädt eine signierte `.rdp`-Datei, injiziert die Credentials per `cmdkey` und startet `mstsc`. Funktioniert primär unter Windows; auf macOS/Linux wird die `.rdp`-Datei nur generiert und der Pfad ausgegeben.

## Syntax

```
ay rdp [id] [flags]
```

## Flags

| Flag | Default | Zweck |
|---|---|---|
| `--list` | — | Listet alle CEs ohne Connect |
| `--no-connect` | — | `.rdp`-Datei generieren, aber nicht starten |

## Beispiele

```bash
# Interaktiver Picker
ay rdp

# Direkt zu einer CE
ay rdp 64a1b2c3d4e5

# Nur Liste
ay rdp --list

# Datei ohne Auto-Connect
ay rdp 64a1b2c3 --no-connect
```

## Verhalten

1. CLI ruft `GET config/computingentities/<id>/actions/rdp-connect` auf.
2. Server liefert `ip`, `username`, `password`, `instanceId`, `rdpFile` (Templated mit IP).
3. CLI patcht `prompt for credentials:i:1` → `:i:0`, schreibt `.rdp` ins `os.tmpdir()`.
4. Auf Windows: `cmdkey /add:<ip> /user:<u> /pass:<p>` → `mstsc <file>`.
5. Auf anderen OS: nur Pfad-Ausgabe.

## Fehlerfälle

- **No public IP** — CE wurde provisioniert aber Cloud-Sync läuft noch. Warten oder `ay sync clusters` triggern.
- **HTTP 403** — Recht `config.computingentities.actions.rdp-connect` fehlt.
- **Provider-Down** — AWS/GCP-State `stopped`/`terminated` → CE muss erst gestartet werden.

## Siehe auch

- [list computingentities](wiki:cli/crud-core/list) — CE-Inventory
- [sync](wiki:cli/devops/sync) — Cloud-State-Sync

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com