Schnellstart: Bereitstellung von Azure API für FHIR mit PowerShell
Wichtig
Azure API for FHIR wird am 30. September 2026 eingestellt. Folgen Sie den Migrationsstrategien, um bis zu diesem Datum zum Azure Health Data Services-FHIR®-Dienst zu wechseln. Aufgrund der Einstellung von Azure API for FHIR werden neue Bereitstellungen ab dem 1. April 2025 nicht zugelassen. Der Azure Health Data Services-FHIR-Dienst ist die weiterentwickelte Version der Azure-API für FHIR, mit der Kundschaft FHIR-, DICOM- und Medizintechnikdienste mit Integrationen in andere Azure-Dienste verwalten kann.
In diesem Schnellstart erfahren Sie, wie Sie Azure API for FHIR mithilfe von PowerShell bereitstellen.
Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
Azure Cloud Shell
Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.
Starten von Azure Cloud Shell:
| Option | Beispiel/Link |
|---|---|
| Wählen Sie rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. |  |
| Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. |  |
| Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. |  |
So verwenden Sie Azure Cloud Shell:
Starten Sie Cloud Shell.
Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.
Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.
Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.
Hinweis
Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Informationen zu den ersten Schritten finden Sie unter Installieren von Azure PowerShell. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.
Registrieren des Azure API for FHIR-Ressourcenanbieters
Wenn der Ressourcenanbieter Microsoft.HealthcareApis noch nicht für Ihr Abonnement registriert ist, können Sie ihn mit dem folgenden Befehl registrieren.
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
Erstellen einer Azure-Ressourcengruppe
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
Bereitstellen von Azure API for FHIR
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
Hinweis
Abhängig von der installierten Version des PowerShell-Moduls Az kann der bereitgestellte FHIR-Server für die Verwendung der lokalen rollenbasierten Zugriffssteuerung (RBAC) konfiguriert werden, und in der Liste der zulässigen Identitätsobjekt-IDs für den bereitgestellten FHIR-Dienst kann der derzeit angemeldete PowerShell-Benutzer festgelegt sein. Es wird empfohlen, Azure RBAC zum Zuweisen von Datenebenenrollen zu verwenden. Möglicherweise müssen Sie die Objekt-ID dieses Benutzers nach der Bereitstellung löschen, um den Azure RBAC-Modus zu aktivieren.
Abrufen der Funktionsbestätigung
Sie können überprüfen, ob das Azure API for FHIR-Konto ausgeführt wird, indem Sie mit den folgenden Befehlen eine FHIR-Funktionsbestätigung abrufen.
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Bereinigen von Ressourcen
Falls Sie diese Anwendung nicht mehr benötigen, löschen Sie die Ressourcengruppe wie folgt.
Remove-AzResourceGroup -Name myResourceGroupName
Nächste Schritte
In diesem Schnellstart haben Sie Azure API for FHIR in Ihrem Abonnement bereitgestellt. Weitere Informationen zu den Einstellungen in der Azure-API für FHIR und zur Verwendung der Azure-API für FHIR finden Sie unter
Hinweis
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.