Quickstart: Azure API for FHIR implementeren met behulp van PowerShell
Belangrijk
Azure API for FHIR wordt op 30 september 2026 buiten gebruik gesteld. Volg de migratiestrategieën om op die datum over te stappen naar de FHIR-service® van Azure Health Data Services. Vanwege de buitengebruikstelling van Azure API for FHIR zijn nieuwe implementaties vanaf 1 april 2025 niet toegestaan. De FHIR-service van Azure Health Data Services is de ontwikkelde versie van Azure API for FHIR waarmee klanten FHIR-, DICOM- en MedTech-services kunnen beheren met integraties in andere Azure-services.
In deze quickstart leert u hoe u Azure API for FHIR implementeert met behulp van PowerShell.
Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Azure Cloud Shell
Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde Cloud Shell-opdrachten gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.
Om Azure Cloud Shell op te starten:
| Optie | Voorbeeld/koppeling |
|---|---|
| Selecteer Uitproberen in de rechterbovenhoek van een code- of opdrachtblok. Als u Try It selecteert, wordt de code of opdracht niet automatisch gekopieerd naar Cloud Shell. |  |
| Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen. |  |
| Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal. |  |
Azure Cloud Shell gebruiken:
Start Cloud Shell.
Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.
Plak de code of opdracht in de Cloud Shell-sessie door Ctrl+Shift+V in Windows en Linux te selecteren of door Cmd+Shift+V te selecteren in macOS.
Selecteer Enter om de code of opdracht uit te voeren.
Notitie
Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.
De Azure-API for FHIR-resourceprovider registreren
Als de Microsoft.HealthcareApis resourceprovider nog niet is geregistreerd voor uw abonnement, kunt u deze registreren met de volgende opdracht.
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
Azure-resourcegroep maken
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
De Azure-API voor FHIR implementeren
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
Notitie
Afhankelijk van de versie van de Az PowerShell-module die u hebt geïnstalleerd, kan de ingerichte FHIR-server worden geconfigureerd voor het gebruik van lokaal op rollen gebaseerd toegangsbeheer (RBAC) en de momenteel aangemelde PowerShell-gebruiker in de lijst met toegestane id's voor de geïmplementeerde FHIR-service. U wordt aangeraden Azure RBAC te gebruiken voor het toewijzen van gegevensvlakrollen. Mogelijk moet u de object-id van deze gebruiker verwijderen na de implementatie om de Azure RBAC-modus in te schakelen.
Mogelijkheidsinstructie ophalen
U kunt controleren of het Azure API for FHIR-account wordt uitgevoerd door een FHIR-mogelijkheidsinstructie op te halen met de volgende opdrachten.
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Resources opschonen
Als u deze toepassing niet wilt blijven gebruiken, verwijdert u de resourcegroep met de volgende stappen.
Remove-AzResourceGroup -Name myResourceGroupName
Volgende stappen
In deze quickstartgids hebt u de Azure API for FHIR geïmplementeerd in uw abonnement. Zie voor meer informatie over de instellingen in Azure API for FHIR en voor het gebruik van Azure API for FHIR
Notitie
FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.