Avvio rapido: Distribuire l'API di Azure per FHIR con PowerShell
Importante
L'API di Azure per FHIR verrà ritirata il 30 settembre 2026. Seguire le strategie di migrazione per passare al servizio FHIR® di Servizi per i dati sanitari di Azure entro tale data. A causa del ritiro dell'API di Azure per FHIR, le nuove distribuzioni non saranno consentite a partire dal 1° aprile 2025. Il servizio FHIR di Servizi per i dati sanitari di Azure è la versione evoluta dell'API di Azure per FHIR che consente ai clienti di gestire i servizi FHIR, DICOM e MedTech con integrazioni in altri servizi di Azure.
Questo argomento di avvio rapido illustra come distribuire l'API di Azure per FHIR usando PowerShell.
Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
Azure Cloud Shell
Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.
Per avviare Azure Cloud Shell:
| Opzione | Esempio/Collegamento |
|---|---|
| Selezionare Prova nell'angolo superiore destro di un blocco di codice o di comando. Quando si seleziona Prova, il codice o il comando non viene copiato automaticamente in Cloud Shell. |  |
| Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. |  |
| Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. |  |
Per usare Azure Cloud Shell:
Avviare Cloud Shell.
Selezionare il pulsante Copia in un blocco di codice (o in un blocco di comando) per copiare il codice o il comando.
Incollare il codice o il comando nella sessione di Cloud Shell selezionando CTRL+MAIUSC+V in Windows e Linux o selezionando CMD+MAIUSC+V in macOS.
Selezionare Invio per eseguire il codice o il comando.
Nota
È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.
Registrare il provider di risorse dell'API di Azure per FHIR
Se il Microsoft.HealthcareApis provider di risorse non è già registrato per la sottoscrizione, è possibile registrarlo con il comando seguente.
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
Creare un gruppo di risorse di Azure
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
Distribuire l'API di Azure per FHIR
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
Nota
A seconda della versione del Az modulo powerShell installato, il server FHIR di cui è stato effettuato il provisioning può essere configurato per l'uso del controllo degli accessi in base al ruolo locale e avere l'utente attualmente connesso a PowerShell nell'elenco degli ID oggetto di identità consentiti per il servizio FHIR distribuito. È consigliabile usare il controllo degli accessi in base al ruolo di Azure per assegnare ruoli del piano dati. Potrebbe essere necessario eliminare l'ID oggetto dell'utente dopo la distribuzione per abilitare la modalità controllo degli accessi in base al ruolo di Azure.
Recuperare la dichiarazione di funzionalità
È possibile verificare che l'account dell'API di Azure per FHIR sia in esecuzione recuperando un'istruzione di funzionalità FHIR con i comandi seguenti.
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Pulire le risorse
Se non si intende continuare a usare questa applicazione, eliminare il gruppo di risorse seguendo questa procedura.
Remove-AzResourceGroup -Name myResourceGroupName
Passaggi successivi
In questa guida introduttiva è stata distribuita l'API di Azure per FHIR nella sottoscrizione. Per altre informazioni sulle impostazioni dell'API di Azure per FHIR e per iniziare a usarla, vedere
Nota
FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.