> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/bereitstellung/infrastructure/moving-azure-resources.md).

# Verschieben von Azure-Ressourcen in ein anderes Abonnement

Empfehlungen zum Verschieben der mit RealmJoin verbundenen Azure-Ressourcen — Key Vault, Log Analytics Workspace, Automation Account und Workplace Cloud Storage — in ein anderes Azure-Abonnement.

{% hint style="warning" %}
**Diese Seite ist eine Empfehlung, kein unterstützter Migrationsdienst.** Die hier beschriebenen Azure-Ressourcen befinden sich in Ihrem eigenen Abonnement und werden von Ihnen verwaltet; RealmJoin verbindet sich nur mit ihnen. Die Verschiebung selbst ist eine Azure-Operation und liegt in Ihrer Verantwortung. Der RealmJoin-Support kann nur begrenzt helfen — vor allem beim anschließenden erneuten Verbinden der Ressourcen mit RealmJoin. Bei Problemen mit der Azure-Verschiebung selbst wenden Sie sich bitte an den Microsoft-Support.
{% endhint %}

## Übersicht

Verwenden Sie Azure **Verschieben → Zu einem anderen Abonnement verschieben** Funktion für jede Ressource statt neue zu erstellen. Eine Verschiebung behält Namen, Endpunkte und Daten bei, sodass die meisten Verbindungen zu RealmJoin weiterhin wie bisher funktionieren.

| Ressource                                                | Wird von RealmJoin verwendet für                        | Was nach der Verschiebung zu tun ist                              |
| -------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------- |
| [Key Vault](#key-vault-laps)                             | LAPS-Kennwörter                                         | Nichts in RealmJoin — nur überprüfen                              |
| [Log Analytics-Arbeitsbereich](#log-analytics-workspace) | Überwachungsprotokoll, Betriebs- und Runbook-Protokolle | Erneut ausführen `Set-RJLogAnalyticsWorkspace` mit dem neuen Ziel |
| [Automation-Konto](#automation-account-runbooks)         | Runbooks                                                | Erneut ausführen `Set-RJAutomationAccount` mit dem neuen Ziel     |
| [Storage Account](#workplace-cloud-storage)              | Workplace-Cloudspeicher                                 | Nichts in RealmJoin — nur überprüfen                              |

## Allgemeine Überlegungen

* **Derselbe Entra ID-Tenant.** Diese Seite setzt voraus, dass das alte und das neue Abonnement demselben Microsoft Entra ID-Tenant angehören. Das Verschieben von Ressourcen in einen anderen Tenant ist ein anderer Fall und wird hier nicht behandelt.
* **Verschieben, nicht neu erstellen.** Eine neue Ressource erhält neue Namen, Schlüssel oder Zertifikate. Für den Key Vault bedeutet das, dass vorhandene LAPS-Kennwörter nicht mehr entschlüsselt werden können (siehe unten).
* **Gleiche Region.** Eine Verschiebung ändert niemals die Region einer Ressource. Erstellen Sie die Ziel-Ressourcengruppe in der **gleichen Region** wie die Ressourcen, die Sie verschieben — für das Automation-Konto ist dies erforderlich (siehe unten).
* **Rollenzuweisungen werden nicht mitverschoben.** Azure-Rollenzuweisungen, die direkt auf einer verschobenen Ressource vorgenommen wurden, werden verwaist und müssen neu erstellt werden. Die RealmJoin-Einrichtungsbefehle erledigen das für Sie.
* **Blocker.** Entfernen Sie Ressourcensperren vorübergehend und prüfen Sie vor dem Start die Azure-Richtlinien des Ziel-Abonnements. Azure validiert jede Verschiebung und meldet, was sie blockiert.
* **Zeitpunkt.** Planen Sie die Verschiebung des Log Analytics Workspace und des Automation-Konto in einer ruhigen Phase und verbinden Sie sie danach sofort wieder (siehe die jeweiligen Abschnitte).

Siehe auch Microsofts [Verschiebungsanleitung](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/move-resource-group-and-subscription) und die Liste der [Ressourcentypen, die Verschiebungen unterstützen](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/move-support-resources).

## Key Vault (LAPS)

RealmJoin speichert nur den DNS-Namen des Key Vault. Der Name bleibt bei einer Verschiebung gleich, daher funktioniert RealmJoin LAPS ohne Änderung in RealmJoin weiter.

{% hint style="danger" %}
**Ersetzen Sie den Key Vault nicht durch einen neuen.** LAPS-Kennwörter werden mit dem `realmjoin-master` Zertifikat verschlüsselt, dessen privater Schlüssel nicht exportierbar ist. Ein neuer Tresor erhält ein neues Zertifikat, und vorhandene Kennwörter können nicht mehr entschlüsselt werden. Key-Vault-Backups können nur innerhalb desselben Abonnements wiederhergestellt werden und sind daher keine Alternative. Das Neuerstellen des Tresors bedeutet, alle LAPS-Konten auf allen Geräten neu zu erstellen.
{% endhint %}

1. Verschieben Sie den Tresor: **Key Vault → Übersicht → Verschieben → Zu einem anderen Abonnement verschieben**. Die Zugriffsrichtlinien (siehe [KeyVault](https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/local-admin-password-solution-laps/keyvault.md)) werden mit dem Tresor verschoben, also gibt es nichts neu zu konfigurieren. Ein Tresor, der für die VM-Datenträgerverschlüsselung verwendet wird, kann nicht verschoben werden.
2. Überprüfen: das Zertifikat `realmjoin-master` existiert weiterhin, und LAPS-Kennwörter können im RealmJoin Portal für einige Geräte weiterhin angezeigt werden.

Während der Verschiebung blockiert Azure nur Verwaltungsoperationen. Das Lesen und Schreiben von Geheimnissen funktioniert weiterhin.

## Log Analytics Workspace

Die Workspace-ID, Ihre Protokolle und die Aufbewahrungseinstellungen bleiben gleich. Allerdings können die [Datenerfassungsregeln](https://docs.realmjoin.com/de/uberwachung-and-protokolle/log-analytics.md#components) die RealmJoin über **nicht verschoben werden**: sie verbleiben im alten Abonnement und verweisen nicht mehr auf den Workspace. Die Rollenzuweisungen für RealmJoin für den Workspace gehen ebenfalls verloren.

{% hint style="warning" %}
Zwischen dem Ende der Verschiebung und der unten beschriebenen erneuten Verbindung kann RealmJoin keine Protokolle schreiben. **Überwachungsprotokolleinträge aus diesem Zeitraum werden später nicht zugestellt.** Verschieben Sie den Workspace in einer ruhigen Phase und verbinden Sie ihn unmittelbar danach erneut.
{% endhint %}

1. Entfernen Sie vor der Verschiebung eventuell vorhandene Lösungen oder ein verbundenes Automation-Konto aus dem Workspace — Azure verschiebt einen Workspace nicht mit verbundenen Diensten.
2. Verschieben Sie den Workspace: **Log Analytics Workspace → Übersicht → Abonnement: ändern**. Wählen Sie nicht die Data Collection Rules (`dcr-rj-*`). Die Verschiebung kann eine Weile dauern.
3. Erstellen Sie einen Skript-Token im RealmJoin Portal unter **Organisation → Features** (<https://portal.realmjoin.com/organization/features>) mit **Skript-Token generieren**. Dies erfordert die Berechtigung zum Bearbeiten von Organisationsfunktionen, und der Token ist nur für begrenzte Zeit gültig.
4. Führen Sie den folgenden Befehl in einer frisch geöffneten lokalen PowerShell-Sitzung aus — nicht in Azure Cloud Shell. Verwenden Sie die **neuen** Abonnement-ID und Ressourcengruppe und die **vorhandenen** Workspace-Namen; ohne den Workspace-Namen würde ein neuer Workspace erstellt.

   ```powershell
   $latest = [version](Find-Module RealmJoin -Repository PSGallery -ErrorAction Stop).Version
   if (-not (Get-Module -ListAvailable RealmJoin | Where-Object Version -ge $latest)) {
       Install-Module RealmJoin -Force -AllowClobber -ErrorAction Stop
   }
   Import-Module RealmJoin -Force
   Set-RJLogAnalyticsWorkspace -ResourceGroupName "<new resource group>" -WorkspaceName "<existing workspace name>" -SubscriptionId "<new subscription ID>" -Token "<script token>" 6>&1
   ```

   Der Befehl lässt den vorhandenen Workspace und seine Daten unverändert, erstellt neue Data Collection Rules in der Region des Workspaces, weist die erforderlichen Rollen zu und registriert die neuen Werte bei RealmJoin. Die Azure- und PowerShell-Voraussetzungen sind dieselben wie für die Ersteinrichtung, siehe [Verbindung mit Azure Log Analytics Workspace](https://docs.realmjoin.com/de/uberwachung-and-protokolle/log-analytics.md#prerequisites).
5. In **Einstellungen → Log Analytics**, wählen Sie **Aktualisieren** und **Auf Konfigurationsprobleme prüfen**. Prüfen Sie dann, ob neue Einträge im [Audit-Protokoll](https://docs.realmjoin.com/de/uberwachung-and-protokolle/audit-log.md).
6. Löschen Sie die alten Data Collection Rules im alten Abonnement.

{% hint style="info" %}
**Verwenden Sie noch die Workspace-ID und den gemeinsamen Schlüssel?** Azure regeneriert die Workspace-Schlüssel während einer Verschiebung, daher stoppt die Protokollierung sofort. Führen Sie den Einrichtungsbefehl wie oben beschrieben aus — er stellt Ihr Tenant auch auf die Log Ingestion API um (siehe [der Migration zur Log Ingestion API](https://docs.realmjoin.com/de/uberwachung-and-protokolle/log-ingestion-api-migration.md)).
{% endhint %}

## Automation-Konto (Runbooks)

Runbooks, Zeitpläne, Variablen und Anmeldeinformationen sowie die verwaltete Identität werden mit dem Automation-Konto verschoben. RealmJoin speichert jedoch das Abonnement und die Ressourcengruppe des Kontos und verliert seine Rollenzuweisung darauf, daher muss das Konto erneut verbunden werden.

{% hint style="warning" %}
Die Ziel-Ressourcengruppe **muss sich in derselben Region befinden** wie das Automation-Konto — der Einrichtungsbefehl stellt das Konto in der Region seiner Ressourcengruppe bereit. Bis das Konto erneut verbunden ist, kann RealmJoin Runbooks nicht synchronisieren oder starten.
{% endhint %}

1. Notieren Sie die Objekt-ID der verwalteten Identität (**Automation-Konto → Kontoeinstellungen → Identität**).
2. Wenn das Automation-Konto mit einem Log Analytics Workspace verknüpft ist (z. B. für Update Management oder Change Tracking), entfernen Sie diese Funktionen und trennen Sie zuerst den Workspace, wie von [Microsoft](https://learn.microsoft.com/en-us/azure/automation/how-to/move-account).
3. Verschieben Sie das Automation-Konto in die Ziel-Ressourcengruppe.
4. Erstellen Sie einen Skript-Token wie für die [Log Analytics-Arbeitsbereich](#log-analytics-workspace) (Schritt 3).
5. Führen Sie den folgenden Befehl in einer frisch geöffneten lokalen PowerShell-Sitzung aus. Verwenden Sie den **neuen** Abonnement-ID und Ressourcengruppe und die **vorhandenen** Namen des Automation-Kontos.

   ```powershell
   $latest = [version](Find-Module RealmJoin -Repository PSGallery -ErrorAction Stop).Version
   if (-not (Get-Module -ListAvailable RealmJoin | Where-Object Version -ge $latest)) {
       Install-Module RealmJoin -Force -AllowClobber -ErrorAction Stop
   }
   Import-Module RealmJoin -Force
   Set-RJAutomationAccount -ResourceGroupName "<new resource group>" -AutomationAccountName "<existing account name>" -SubscriptionId "<new subscription ID>" -Token "<script token>" 6>&1
   ```

   Der Befehl weist die Rolle für RealmJoin auf dem Konto erneut zu und registriert die neuen Werte bei RealmJoin. Die Azure- und PowerShell-Voraussetzungen sind dieselben wie für die Ersteinrichtung, siehe [Verbindung mit Azure Automation](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation.md#prerequisites).
6. Überprüfen:
   * Die Objekt-ID der verwalteten Identität ist unverändert. Falls sie sich geändert hat, erteilen Sie ihr [Rollen und Berechtigungen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/azure-ad-roles-and-permissions.md#granting-roles-and-permissions) erneut.
   * **Einstellungen → Runbooks → Aktualisieren** zeigt die neuen Werte an und die Runbook-Synchronisierung wird abgeschlossen.
   * Ein Test-Runbook läuft erfolgreich.
   * Wenn Sie [Hybrid Runbook Workers](https://docs.realmjoin.com/de/automatisierung/runbooks/hybrid-runbook-worker.md)verwenden, stellen sie weiterhin eine Verbindung her.

## Workplace-Cloudspeicher

RealmJoin verbindet sich über seine Verbindungszeichenfolge mit dem Storage Account, die den Kontonamen und den Zugriffsschlüssel enthält. Beide bleiben bei einer Verschiebung gleich, daher funktionieren die öffentlichen URLs Ihrer Favoriten, Hintergründe, Dateien und Signaturen weiterhin.

1. Verschieben Sie den Storage Account in die Ziel-Ressourcengruppe.
2. Überprüfen: Laden Sie im RealmJoin Portal unter **Organisation → Andere Dateien**. Wenn ein Fehler auftritt, kopieren Sie die Verbindungszeichenfolge erneut von **Storage Account → Zugriffsschlüssel** und speichern Sie sie unter **Einstellungen → Workplace-Cloudspeicher** (siehe [Workplace-Cloudspeicher](https://docs.realmjoin.com/de/administration-and-einstellungen/workplace-cloud-storage.md#create-storage-account)).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/bereitstellung/infrastructure/moving-azure-resources.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
