Delen via


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 wordt uitgelegd 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. Schermopname van een voorbeeld van Probeer het nu voor Azure Cloud Shell.
Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen. Knop om Azure Cloud Shell te starten.
Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal. Schermopname van de knop Cloud Shell in Azure Portal

Azure Cloud Shell gebruiken:

  1. Start Cloud Shell.

  2. Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.

  3. 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.

  4. 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 bij:

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 AzPowerShell-module die u hebt geïnstalleerd, kan de ingerichte FHIR-server worden geconfigureerd om lokale RBAC te gebruiken, waarbij de dan aangemelde PowerShell-gebruiker op de lijst met toegestane identiteitsobject-id's voor de geïmplementeerde FHIR-service staat. Het wordt aanbevolen om daarna Azure RBAC te gebruiken voor het toewijzen van gegevenslaagrollen. Mogelijk moet u deze gebruikersobject-id na de implementatie verwijderen om de modus Azure RBAC in te schakelen.

Mogelijkheidsinstructie ophalen

U kunt controleren of de Azure-API voor het FHIR-account wordt uitgevoerd door een FHIR-mogelijkheidsinstructie op te halen:

$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent

Resources opschonen

Als u deze toepassing verder niet gaat gebruiken, verwijder dan de resourcegroep met de volgende stappen:

Remove-AzResourceGroup -Name myResourceGroupName

Volgende stappen

In deze quickstart hebt u de Azure-API voor 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

FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.