Connessione a Microsoft Azure
Nota:
Da luglio 2023, Microsoft ha rinominato Azure Active Directory (Azure AD) in Microsoft Entra ID. In questo documento, qualsiasi riferimento ad Azure Active Directory, Azure AD o AAD ora si riferisce a Microsoft Entra ID.
Creare e gestire connessioni e risorse descrive le procedure guidate che creano una connessione. Le seguenti informazioni riguardano i dettagli specifici degli ambienti cloud di Azure Resource Manager.
Nota:
Prima di creare una connessione a Microsoft Azure, è necessario completare la configurazione del proprio account Azure come posizione delle risorse. Vedere Ambienti cloud Microsoft Azure Resource Manager.
Creare entità servizio e connessioni
Prima di creare connessioni, è necessario configurare le entità servizio usate dalle connessioni per accedere alle risorse di Azure. È possibile creare una connessione in due modi:
- Creare un’entità servizio e una connessione allo stesso tempo utilizzando Web Studio
- Creare una connessione utilizzando un’entità servizio creata in precedenza
Questa sezione mostra come completare queste attività:
- Creare un’entità servizio e una connessione utilizzando Web Studio
- Creare un’entità servizio utilizzando PowerShell
- Ottenere il segreto dell’applicazione in Azure
- Creare una connessione utilizzando un’entità servizio esistente
Considerazioni
- Citrix consiglia di utilizzare Service Principal con ruolo di collaboratore. Tuttavia, consulta la sezione Autorizzazioni minime per ottenere l’elenco delle autorizzazioni minime.
- Quando si crea la prima connessione, Azure richiede di concederle le autorizzazioni necessarie. Per le connessioni future è comunque necessario autenticarsi, ma Azure ricorda il consenso precedente e non visualizza più la richiesta.
- Gli account utilizzati per l’autenticazione devono essere co-amministratori della sottoscrizione.
- L’account utilizzato per l’autenticazione deve essere un membro della directory della sottoscrizione. Esistono due tipi di account di cui tenere conto: “lavoro o scuola” e “account Microsoft personale”. Vedere CTX219211 per i dettagli.
-
Sebbene sia possibile utilizzare un account Microsoft esistente aggiungendolo come membro della directory della sottoscrizione, possono verificarsi complicazioni se all’utente è stato precedentemente concesso l’accesso come ospite a una delle risorse della directory. In questo caso, potrebbe essere presente una voce di segnaposto nella directory che non concede loro le autorizzazioni necessarie e viene restituito un errore.
Correggere questo problema rimuovendo le risorse dalla directory e aggiungendole di nuovo esplicitamente. Tuttavia, utilizzare questa opzione con attenzione, perché ha effetti indesiderati su altre risorse a cui l’account può accedere.
- Esiste un problema noto per cui alcuni account vengono rilevati come ospiti della directory quando invece sono membri. Configurazioni come questa si verificano in genere con account di directory consolidati precedenti. Soluzione: aggiungere un account alla directory, che assume il valore di appartenenza corretto.
- I gruppi di risorse sono semplicemente contenitori per le risorse e possono contenere risorse provenienti da regioni diverse dalla propria. Ciò può creare potenzialmente confusione se si prevede che le risorse visualizzate nella regione di un gruppo di risorse siano disponibili.
- Assicurarsi che la rete e la subnet siano sufficientemente grandi da ospitare il numero di macchine necessarie. Ciò richiede una certa lungimiranza, ma Microsoft aiuta a specificare i valori corretti, con indicazioni sulla capacità dello spazio degli indirizzi.
Creare un’entità servizio e una connessione utilizzando Web Studio
Importante:
Questa funzionalità non è ancora disponibile per le sottoscrizioni di Azure in Cina.
Con Web Studio è possibile creare sia un’entità servizio che una connessione in un unico flusso di lavoro. Le entità servizio consentono alle connessioni di accedere alle risorse di Azure. Quando si esegue l’autenticazione in Azure per creare un’entità servizio, un’applicazione viene registrata in Azure. Viene creata una chiave segreta (chiamata segreto del client o segreto dell’applicazione) per l’applicazione registrata. L’applicazione registrata (in questo caso una connessione) utilizza il segreto del client per l’autenticazione in Azure AD.
Prima di iniziare, assicurarsi che siano soddisfatti questi prerequisiti:
- Avere un account utente nel tenant Azure Active Directory della propria sottoscrizione.
- L’account utente Azure AD sia anche co-amministratore per la sottoscrizione di Azure che si desidera utilizzare per il provisioning delle risorse.
- Si dispone delle autorizzazioni di amministratore globale, amministratore dell’applicazione o sviluppatore di applicazioni per l’autenticazione. Queste autorizzazioni possono essere revocate dopo aver creato una connessione host. Per ulteriori informazioni sui ruoli, vedere Ruoli predefiniti di Azure AD.
Utilizzare la procedura guidata Add Connection and Resources (Aggiungi connessione e risorse) per creare insieme un’entità servizio e una connessione allo stesso tempo:
-
Nella pagina Connection (Connessione), selezionare Create a new connetion (Crea una nuova connessione), il tipo di connessione Microsoft Azure e l’ambiente Azure.
-
Selezionare gli strumenti da utilizzare per creare le macchine virtuali, quindi selezionare Next (Avanti).
-
Nella pagina Connection Details (Dettagli connessione), inserire il proprio ID sottoscrizione di Azure e un nome per la connessione. Dopo aver inserito l’ID sottoscrizione, viene abilitato il pulsante Create new (Crea nuova).
Nota:
Il nome della connessione può contenere da 1 a 64 caratteri e non può contenere solo spazi vuoti né i caratteri
\/;:#.*?=<>|[]{}"'()'
. -
Selezionare Create new (Crea nuova), quindi inserire il nome utente e la password dell’account Azure Active Directory.
-
Selezionare Sign in (Accedi).
-
Selezionare Accept (Accetta) per concedere a Citrix Virtual Apps and Desktops le autorizzazioni elencate. Citrix Virtual Apps and Desktops crea un’entità servizio che consente di gestire le risorse di Azure per conto dell’utente specificato.
-
Dopo aver selezionato Accept (Accetta), si torna alla pagina Connection (Connessione) della procedura guidata.
Nota:
Dopo aver eseguito l’autenticazione in Azure, i pulsanti Create new (Crea nuova) e Use existing (Usa esistente) scompaiono. Viene visualizzato il testo Connection successful (Connessione riuscita), con un segno di spunta verde che indica la connessione riuscita alla sottoscrizione di Azure.
-
Nella pagina Connection Details (Dettagli connessione), selezionare Next (Avanti).
Nota:
Non è possibile passare alla pagina successiva finché non ci si autentica correttamente in Azure e non si acconsente a concedere le autorizzazioni richieste.
-
Configurare le risorse per la connessione. Le risorse comprendono la regione e la rete.
- Nella pagina Region (Regione), selezionare una regione.
- Nella pagina Network (Rete), procedere come segue:
- Digitare un nome da 1 a 64 caratteri per la risorsa, per semplificare l’identificazione della combinazione di regione e rete. Il nome di una risorsa non può contenere solo spazi vuoti né i caratteri
\/;:#.*?=<>|[]{}"'()'
. - Selezionare una coppia rete virtuale/gruppo di risorse (se si dispone di più di una rete virtuale con lo stesso nome, l’associazione del nome della rete con il gruppo di risorse fornisce combinazioni univoche). Se la regione selezionata nella pagina precedente non dispone di reti virtuali, tornare a quella pagina e selezionare una regione con reti virtuali.
- Digitare un nome da 1 a 64 caratteri per la risorsa, per semplificare l’identificazione della combinazione di regione e rete. Il nome di una risorsa non può contenere solo spazi vuoti né i caratteri
-
Nella pagina Summary (Riepilogo), visualizzare un riepilogo delle impostazioni e selezionare Finish (Fine) per completare la configurazione.
Visualizzare l’ID dell’applicazione
Dopo aver creato una connessione, è possibile visualizzare l’ID dell’applicazione utilizzata dalla connessione per accedere alle risorse di Azure.
Nell’elenco Add Connection and Resources (Aggiungi connessione e risorse), selezionare la connessione per visualizzare i dettagli. La scheda Details (Dettagli) mostra l’ID dell’applicazione.
Creare un’entità servizio utilizzando PowerShell
Per creare un’entità servizio utilizzando PowerShell, connettersi alla sottoscrizione di Azure Resource Manager e utilizzare i cmdlet PowerShell forniti nelle sezioni seguenti.
Assicurarsi di avere a portata di mano quanto segue:
-
SubscriptionId:
SubscriptionID
di Azure Resource Manager per la sottoscrizione in cui si desidera eseguire il provisioning di VDA. - ActiveDirectoryID: ID tenant dell’applicazione registrata con Azure AD.
- ApplicationName: nome dell’applicazione da creare in Azure AD.
I passaggi dettagliati sono i seguenti:
Connettersi alla sottoscrizione Azure Resource Manager.
`Connect-AzAccount`
-
Selezionare la sottoscrizione Azure Resource Manager in cui si desidera creare l’entità servizio.
Get-AzSubscription -SubscriptionId $subscriptionId | Select-AzSubscription
-
Creare l’applicazione nel proprio tenant AD.
$AzureADApplication = New-AzADApplication -DisplayName $ApplicationName
-
Creare un’entità servizio.
New-AzADServicePrincipal -ApplicationId $AzureADApplication.AppId
-
Assegnare un ruolo all’entità servizio.
New-AzRoleAssignment -RoleDefinitionName Contributor -ServicePrincipalName $AzureADApplication.AppId –scope /subscriptions/$SubscriptionId
-
Dalla finestra di output della console PowerShell, prendere nota dell’ApplicationId. Fornire questo ID quando si crea la connessione host.
Ottenere il segreto dell’applicazione in Azure
Per creare una connessione utilizzando un’entità servizio esistente, è prima necessario ottenere l’ID e il segreto dell’applicazione dell’entità servizio nel portale di Azure.
I passaggi dettagliati sono i seguenti:
- Ottenere l’ID dell’applicazione da Web Studio o utilizzando PowerShell.
- Accedere al portale di Azure.
- In Azure, selezionare Azure Active Directory.
- Da Registrazioni app in Azure AD, selezionare la propria applicazione.
- Andare a Certificati e segreti.
- Fare clic su Client secrets (Segreti client).
Creare una connessione utilizzando un’entità servizio esistente
Se si dispone già di un’entità servizio, è possibile utilizzarla per creare una connessione utilizzando Web Studio.
Assicurarsi di avere a portata di mano quanto segue:
- SubscriptionId
- ActiveDirectoryID (tenant ID)
- ID applicazione
-
Segreto dell’applicazione
Per ulteriori informazioni, vedere Ottenere il segreto dell’applicazione.
- Data di scadenza del segreto
I passaggi dettagliati sono i seguenti:
Nella procedura guidata Add Connection and Resources (Aggiungi connessione e risorse):
-
Nella pagina Connection (Connessione), selezionare Create a new connetion (Crea una nuova connessione), il tipo di connessione Microsoft Azure e l’ambiente Azure.
-
Selezionare gli strumenti da utilizzare per creare le macchine virtuali, quindi selezionare Next (Avanti).
-
Nella pagina Connection Details (Dettagli connessione), inserire il proprio ID sottoscrizione di Azure e un nome per la connessione.
Nota:
Il nome della connessione può contenere da 1 a 64 caratteri e non può contenere solo spazi vuoti né i caratteri
\/;:#.*?=<>|[]{}"'()'
. -
Selezionare Use existing (Usa esistente). Nella finestra Existing Service Principal Details (Dettagli entità servizio esistente), immettere le seguenti impostazioni per l’entità servizio esistente. Dopo aver inserito i dettagli, il pulsante Save (Salva) è abilitato. Selezionare Save (Salva). Non è possibile andare oltre questa pagina finché non si forniscono dettagli validi.
- Subscription ID (ID sottoscrizione). Inserire il proprio ID sottoscrizione di Azure. Per ottenere l’ID sottoscrizione, accedere al portale di Azure e andare a Sottoscrizioni > Panoramica.
- Active Directory ID (ID Active Directory) (ID tenant). Inserire l’ID Directory (tenant) dell’applicazione che si è registrata con Azure AD.
- Application ID (ID applicazione). Inserire l’ID applicazione (client) dell’applicazione registrata con Azure AD.
- Application secret (Segreto dell’applicazione). Creare una chiave segreta (segreto client). L’applicazione registrata utilizza la chiave per l’autenticazione in Azure AD. Si consiglia di cambiare le chiavi regolarmente per motivi di sicurezza. Assicurarsi di salvare la chiave, perché non è possibile recuperarla in un secondo momento.
-
Secret expiration date (Data di scadenza del segreto). Immettere la data dopo la quale il segreto dell’applicazione scade. Si riceverà un avviso sulla console prima della scadenza della chiave segreta. Tuttavia, se la chiave segreta scade, si ricevono errori.
Nota:
Per motivi di sicurezza, il periodo di scadenza non può essere superiore a due anni da oggi.
- Authentication URL (URL di autenticazione). Questo campo viene compilato automaticamente e non è modificabile.
- Management URL (URL di gestione). Questo campo viene compilato automaticamente e non è modificabile.
-
Storage suffix (Suffisso di archiviazione). Questo campo viene compilato automaticamente e non è modificabile.
L’accesso ai seguenti endpoint è necessario per creare un catalogo MCS in Azure. L’accesso a questi endpoint ottimizza la connettività tra la rete e il portale di Azure e i relativi servizi.
- Authentication URL: https://login.microsoftonline.com/
- Management URL: https://management.azure.com/. Questo è un URL di richiesta per le API del provider di Azure Resource Manager. L’endpoint per la gestione dipende dall’ambiente. Ad esempio, per Azure Global è https://management.azure.com/ e per Azure US Government è https://management.usgovcloudapi.net/.
- Storage suffix: https://*.core.windows.net./. Questo (*) è un carattere jolly per il suffisso di archiviazione. Ad esempio,
https://demo.table.core.windows.net/
.
-
Dopo aver selezionato Save (Salva), si torna alla pagina Connection Details (Dettagli connessione). Selezionare Next (Avanti) per passare alla pagina successiva.
-
Configurare le risorse per la connessione. Le risorse comprendono la regione e la rete.
- Nella pagina Region (Regione), selezionare una regione.
- Nella pagina Network (Rete), procedere come segue:
- Digitare un nome da 1 a 64 caratteri per la risorsa, per semplificare l’identificazione della combinazione di regione e rete. Il nome di una risorsa non può contenere solo spazi vuoti né i caratteri
\/;:#.*?=<>|[]{}"'()'
. - Selezionare una coppia rete virtuale/gruppo di risorse (se si dispone di più di una rete virtuale con lo stesso nome, l’associazione del nome della rete con il gruppo di risorse fornisce combinazioni univoche). Se la regione selezionata nella pagina precedente non dispone di reti virtuali, tornare a quella pagina e selezionare una regione con reti virtuali.
- Digitare un nome da 1 a 64 caratteri per la risorsa, per semplificare l’identificazione della combinazione di regione e rete. Il nome di una risorsa non può contenere solo spazi vuoti né i caratteri
-
Nella pagina Summary (Riepilogo), visualizzare un riepilogo delle impostazioni e selezionare Finish (Fine) per completare la configurazione.
Gestire le entità servizio e le connessioni
Questa sezione descrive in dettaglio come gestire le entità servizio e le connessioni:
- Configurare le impostazioni di limitazione delle richieste di Azure
- Abilitare la condivisione di immagini in Azure
- Aggiungere tenant condivisi a una connessione utilizzando Full Configuration
- Implementare la condivisione di immagini tramite PowerShell
- Gestire il segreto dell’applicazione e la data di scadenza del segreto
Configurare le impostazioni di limitazione delle richieste di Azure
Azure Resource Manager limita le richieste di sottoscrizione e tenant, instradando il traffico in base a limiti definiti, a seconda delle esigenze specifiche del provider. Per ulteriori informazioni, vedere Limitazione delle richieste di Resource Manager sul sito Microsoft. Sono previsti dei limiti per sottoscrizioni e tenant, a causa dei quali la gestione di molte macchine può diventare problematica. Ad esempio, in una sottoscrizione contenente molte macchine potrebbero verificarsi dei problemi di prestazioni relativi alle operazioni di alimentazione.
Suggerimento:
Per ulteriori informazioni, vedere Miglioramento delle prestazioni di Azure con Machine Creation Services.
Per contribuire a mitigare questi problemi, è possibile rimuovere la limitazione delle richieste interna di MCS per utilizzare maggiormente la quota di richieste disponibile da Azure.
Si consigliano le seguenti impostazioni ottimali quando si accendono o si spengono le macchine virtuali in sottoscrizioni di grandi dimensioni, ad esempio quelle contenenti 1.000 macchine virtuali:
- Operazioni simultanee assolute: 500
- Numero massimo di nuove operazioni al minuto: 2.000
- Numero massimo di operazioni simultanee: 500
Utilizzare Web Studio per configurare le operazioni di Azure per una determinata connessione Azure:
- In Web Studio, selezionare Hosting nel riquadro a sinistra.
- Selezionare la connessione.
- Nella procedura guidata Edit Connection (Modifica connessione), selezionare Advanced (Avanzate).
- Nella pagina Advanced (Avanzate), utilizzare le opzioni di configurazione per specificare il numero di azioni simultanee e il numero massimo di nuove azioni al minuto, nonché eventuali opzioni di connessione aggiuntive.
MCS supporta massimo 500 operazioni simultanee per impostazione predefinita. In alternativa, è possibile utilizzare l’SDK Remote PowerShell per impostare il numero massimo di operazioni simultanee.
Utilizzare la proprietà PowerShell MaximumConcurrentProvisioningOperations
per specificare il numero massimo di operazioni di provisioning simultanee di Azure. Quando si utilizza questa proprietà, considerare:
- Il valore predefinito di
MaximumConcurrentProvisioningOperations
è 500. - Configurare il parametro
MaximumConcurrentProvisioningOperations
utilizzando il comando PowerShellSet-item
.
Abilitare la condivisione di immagini in Azure
Quando si creano o si aggiornano cataloghi delle macchine, è possibile selezionare immagini condivise provenienti da diverse sottoscrizioni e tenant di Azure (condivise tramite la Raccolta di calcolo di Azure). Per abilitare la condivisione di immagini all’interno di tenant o fra uno e l’altro, è necessario configurare le impostazioni necessarie in Azure:
Condividere immagini all’interno di un tenant (tra abbonamenti)
Perché sia possibile selezionare in Raccolta di calcolo di Azure un’immagine che appartiene a una sottoscrizione diversa, l’immagine deve essere condivisa con l’entità servizio (SPN) di quella sottoscrizione.
Ad esempio, se esiste un’entità servizio (SPN 1) configurata in Studio come:
Entità servizio: SPN 1
Subscription: subscription 1
Tenant: tenant 1
L’immagine è in una sottoscrizione diversa, che è configurata in Studio come:
Subscription: subscription 2
Tenant: tenant 1
Se si intende condividere l’immagine della sottoscrizione 2 con la sottoscrizione 1 (SPN 1), passare alla sottoscrizione2 e condividere il gruppo di risorse con SPN1.
L’immagine deve essere condivisa con un altro SPN utilizzando il controllo degli accessi in base al ruolo di Azure (RBAC). Azure RBAC è il sistema di autorizzazione usato per gestire l’accesso alle risorse di Azure. Per ulteriori informazioni su Azure RBAC, vedere il documento Microsoft Che cos’è il controllo degli accessi in base al ruolo di Azure. Per concedere l’accesso, si assegnano ruoli alle entità servizio nell’ambito del gruppo di risorse con il ruolo di collaboratore. Per assegnare i ruoli di Azure, è necessario disporre di un’autorizzazione Microsoft.Authorization/roleAssignments/write
, come nel caso di un Amministratore Accesso utenti o un Proprietario. Per ulteriori informazioni sulla condivisione di immagini con un altro SPN, vedere il documento Microsoft Assegnare ruoli di Azure usando il portale di Azure.
Per informazioni sulla selezione di un’immagine da una sottoscrizione diversa mediante i comandi PowerShell, vedere Selezionare un’immagine da un’altra sottoscrizione.
Condividere immagini tra tenant
Per condividere immagini tra tenant con la Raccolta di calcolo di Azure, creare una registrazione dell’applicazione.
Ad esempio, se ci sono due tenant (Tenant 1 e Tenant 2) e si desidera condividere la propria galleria di immagini con Tenant 1, allora:
-
Creare una domanda di registrazione per Tenant 1. Per ulteriori informazioni, vedere Creare la registrazione dell’app.
-
Consentire a Tenant 2 di accedere all’applicazione richiedendo l’accesso tramite un browser. Sostituire
Tenant2 ID
con l’ID tenant del Tenant 1. SostituireApplication (client) ID
con l’ID dell’applicazione della registrazione dell’applicazione creata. Quando si sono completate le sostituzioni, incollare l’URL in un browser e seguire le istruzioni di accesso per accedere al Tenant 2. Ad esempio:https://login.microsoftonline.com/<Tenant 2 ID>/oauth2/authorize?client_id=<Application (client) ID>&response_type=code&redirect_uri=https%3A%2F%2Fwww.microsoft.com%2F <!--NeedCopy-->
Per ulteriori informazioni, vedere Concedere l’accesso al tenant 2.
-
Concedere all’applicazione l’accesso al gruppo di risorse Tenant 2. Accedere come Tenant 2 e concedere alla registrazione dell’app l’accesso al gruppo di risorse che contiene l’immagine della raccolta. Per ulteriori informazioni, vedere Eseguire l’autenticazione delle richieste su più tenant.
Per creare un catalogo utilizzando un’immagine di un tenant diverso utilizzando i comandi PowerShell:
- Aggiornare le proprietà personalizzate della connessione di hosting con ID tenant condivisi.
- Selezionare un’immagine da un altro tenant.
Aggiungere tenant condivisi a una connessione utilizzando Full Configuration
Quando si creano o si aggiornano cataloghi delle macchine in Web Studio, è possibile selezionare immagini condivise provenienti da diverse sottoscrizioni e tenant di Azure (condivise tramite la Raccolta di calcolo di Azure). La funzionalità richiede che vengano fornite informazioni condivise sul tenant e sulla sottoscrizione per le connessioni host associate.
Nota:
Assicurarsi di aver configurato le impostazioni necessarie in Azure per abilitare la condivisione di immagini tra tenant. Per ulteriori informazioni, vedere Condividere immagini tra tenant.
Completare i seguenti passaggi per una connessione:
- In Web Studio, selezionare Hosting nel riquadro a sinistra.
-
Selezionare la connessione e quindi selezionare Edit Connection (Modifica connessione) nella barra delle azioni.
-
In Shared Tenants (Tenant condivisi), procedere come segue:
- Fornire l’ID dell’applicazione e il segreto dell’applicazione associati alla sottoscrizione della connessione. Citrix Virtual Apps and Desktops utilizza queste informazioni per l’autenticazione in Azure AD.
- Aggiungere tenant e sottoscrizioni che condividono la Raccolta di calcolo di Azure con la sottoscrizione della connessione. È possibile aggiungere fino a 8 tenant condivisi e 8 sottoscrizioni per ogni tenant.
- Al termine, selezionare Apply (Applica) per applicare le modifiche apportate e mantenere aperta la finestra oppure selezionare OK per applicare le modifiche e chiudere la finestra.
Implementare la condivisione di immagini tramite PowerShell
Questa sezione illustra i processi di condivisione delle immagini tramite PowerShell:
- Selezionare un’immagine da un’altra sottoscrizione
- Aggiornare le proprietà personalizzate della connessione di hosting con ID tenant condivisi
- Selezionare un’immagine da un altro tenant
Selezionare un’immagine da un’altra sottoscrizione
È possibile selezionare un’immagine in Raccolta di calcolo di Azure che appartiene a una sottoscrizione condivisa diversa all’interno dello stesso tenant di Azure per creare e aggiornare i cataloghi MCS usando i comandi di PowerShell.
- Nella cartella principale dell’unità di hosting, Citrix crea una nuova cartella di sottoscrizione condivisa chiamata
sharedsubscription
. -
Elencare tutte le sottoscrizioni condivise di un tenant.
Get-ChildItem -Path "XDhyp:\HostingUnits\azres\sharedsubscription.folder" <!--NeedCopy-->
-
Selezionare un abbonamento condiviso, quindi elencare tutti i gruppi di risorse condivise di quella sottoscrizione condivisa.
Get-ChildItem -Path "XDhyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription" <!--NeedCopy-->
-
Selezionare un gruppo di risorse, quindi elencare tutte le gallerie di quel gruppo di risorse.
Get-ChildItem -Path "XDhyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription\ xyz.resourcegroup" <!--NeedCopy-->
-
Selezionare una raccolta, quindi elencare tutte le definizioni delle immagini di quella raccolta.
Get-ChildItem -Path "XDhyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription\xyz.resourcegroup\testgallery.gallery" <!--NeedCopy-->
-
Selezionare una definizione di immagine, quindi elencare tutte le versioni dell’immagine in questione.
Get-ChildItem -Path "XDhyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription\xyz.resourcegroup\sigtestdef.imagedefinition" <!--NeedCopy-->
-
Creare e aggiornare un catalogo MCS utilizzando i seguenti elementi:
- Gruppo di risorse
- Raccolta
- Definizione delle immagini della raccolta
- Versione delle immagini della raccolta.
Per informazioni su come creare un catalogo utilizzando l’SDK Remote PowerShell, vedere https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.
Aggiornare le proprietà personalizzate della connessione di hosting con ID tenant condivisi
Utilizzare Set-Item
per aggiornare le proprietà personalizzate della connessione di hosting con ID tenant e ID di abbonamento condivisi. Aggiungere una proprietà SharedTenants
in CustomProperties
. Il formato di Shared Tenants
è:
[{"Tenant":"94367291-119e-457c-bc10-25337231f7bd","Subscriptions":["7bb42f40-8d7f-4230-a920-be2781f6d5d9"]},{"Tenant":"50e83564-c4e5-4209-b43d-815c45659564","Subscriptions":["06ab8944-6a88-47ee-a975-43dd491a37d0"]}]
<!--NeedCopy-->
Ad esempio:
Set-Item -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`">
<Property xsi:type=`"StringProperty`" Name=`"SubscriptionId`" Value=`"123`" />
<Property xsi:type=`"StringProperty`" Name=`"ManagementEndpoint`" Value=`"https://management.azure.com/`" />
<Property xsi:type=`"StringProperty`" Name=`"AuthenticationAuthority`" Value=`"https://login.microsoftonline.com/`" />
<Property xsi:type=`"StringProperty`" Name=`"StorageSuffix`" Value=`"core.windows.net`" />
<Property xsi:type=`"StringProperty`" Name=`"TenantId`" Value=`"123abc`" />
<Property xsi:type=`"StringProperty`" Name=`"SharedTenants`" Value=`"`[ { 'Tenant':'123abc', 'Subscriptions':['345', '567'] } ]`"` />
</CustomProperties>"
-LiteralPath @("XDHyp:\Connections\aazure") -PassThru -UserName "advc345" -SecurePassword
$psd
<!--NeedCopy-->
Nota:
È possibile aggiungere più di un tenant. Ogni inquilino può avere più di una sottoscrizione.
Selezionare un’immagine da un altro tenant
È possibile selezionare nella Raccolta di calcolo di Azure un’immagine che appartiene a un diverso tenant di Azure per creare e aggiornare i cataloghi MCS usando i comandi di PowerShell.
- Nella cartella principale dell’unità di hosting, Citrix crea una nuova cartella di sottoscrizione condivisa chiamata
sharedsubscription
. -
Elencare tutte le sottoscrizioni condivise.
Get-ChildItem XDHyp:\HostingUnits\azres\sharedsubscription.folder <!--NeedCopy-->
-
Selezionare un abbonamento condiviso, quindi elencare tutti i gruppi di risorse condivise di quella sottoscrizione condivisa.
Get-ChildItem XDHyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription <!--NeedCopy-->
-
Selezionare un gruppo di risorse, quindi elencare tutte le gallerie di quel gruppo di risorse.
Get-ChildItem XDHyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription\ xyz.resourcegroup <!--NeedCopy-->
-
Selezionare una raccolta, quindi elencare tutte le definizioni delle immagini di quella raccolta.
Get-ChildItem XDHyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription\xyz.resourcegroup\efg.gallery <!--NeedCopy-->
-
Selezionare una definizione di immagine, quindi elencare tutte le versioni dell’immagine in questione.
Get-ChildItem XDHyp:\HostingUnits\azres\image.folder\abc123.sharedsubscription\xyz.resourcegroup\efg.gallery\hij.imagedefinition <!--NeedCopy-->
-
Creare e aggiornare un catalogo MCS utilizzando i seguenti elementi:
- Gruppo di risorse
- Raccolta
- Definizione delle immagini della raccolta
- Versione delle immagini della raccolta.
Per informazioni su come creare un catalogo utilizzando l’SDK Remote PowerShell, vedere https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.
Gestire il segreto dell’applicazione e la data di scadenza del segreto
Accertarsi di aver modificato il segreto dell’applicazione per una connessione prima della scadenza del segreto. Si riceverà un avviso su Web Studio prima della scadenza della chiave segreta.
Creare un segreto dell’applicazione in Azure
È possibile creare un segreto dell’applicazione per una connessione tramite il portale di Azure.
- Selezionare Azure Active Directory.
- Da Registrazioni app in Azure AD, selezionare la propria applicazione.
- Andare a Certificati e segreti.
- Fare clic su Segreti client > Nuovo segreto client.
-
Fornire una descrizione del segreto e specificare una durata. Al termine, selezionare Add (Aggiungi).
Nota:
Assicurarsi di salvare il segreto del client, perché non è possibile recuperarlo in un secondo momento.
- Copiare il valore del segreto del client e la data di scadenza.
- In Web Studio modificare la connessione corrispondente e sostituire il contenuto nei campi Application secret (Segreto applicazione) e Secret expiration date (Data di scadenza del segreto) con i valori copiati.
Modificare la data di scadenza del segreto
È possibile utilizzare Web Studio per aggiungere o modificare la data di scadenza del segreto dell’applicazione in uso.
- Nella procedura guidata Add Connection and Resources (Aggiungi connessione e risorse), fare clic con il pulsante destro del mouse su una connessione e fare clic su Edit Connection (Modifica connessione).
- Nella pagina Connection Properties (Proprietà connessione), fare clic su Secret expiration date (Data di scadenza del segreto) per aggiungere o modificare la data di scadenza del segreto dell’applicazione in uso.
Autorizzazioni Azure richieste
Questa sezione contiene le autorizzazioni minime e generali richieste per Azure.
Autorizzazioni minime
Le autorizzazioni minime offrono un migliore controllo della sicurezza. Tuttavia, le nuove funzionalità che richiedono autorizzazioni aggiuntive non funzionano se si utilizzano solo le autorizzazioni minime.
Creazione di una connessione host
Aggiungere una nuova connessione host utilizzando le informazioni ottenute da Azure.
"Microsoft.Network/virtualNetworks/read",
"Microsoft.Compute/virtualMachines/read",
"Microsoft.Compute/disks/read",
<!--NeedCopy-->
Gestione dell’alimentazione delle macchine virtuali
Accendere o spegnere le istanze della macchina.
"Microsoft.Compute/virtualMachines/read",
"Microsoft.Resources/subscriptions/resourceGroups/read",
"Microsoft.Compute/virtualMachines/deallocate/action",
"Microsoft.Compute/virtualMachines/start/action",
"Microsoft.Compute/virtualMachines/restart/action",
<!--NeedCopy-->
Creazione, aggiornamento o eliminazione di macchine virtuali
Creare un catalogo delle macchine, quindi aggiungere, eliminare, aggiornare le macchine ed eliminare il catalogo delle macchine.
Di seguito è riportato l’elenco delle autorizzazioni minime richieste quando l’immagine master è un disco gestito o le snapshot si trovano nella stessa area geografica della connessione di hosting.
"Microsoft.Resources/subscriptions/resourceGroups/read",
"Microsoft.Resources/deployments/validate/action",
"Microsoft.Compute/virtualMachines/read",
"Microsoft.Compute/virtualMachines/write",
"Microsoft.Compute/virtualMachines/delete",
"Microsoft.Compute/virtualMachines/deallocate/action",
"Microsoft.Compute/snapshots/read",
"Microsoft.Compute/snapshots/write",
"Microsoft.Compute/snapshots/delete",
"Microsoft.Compute/snapshots/beginGetAccess/action",
"Microsoft.Compute/snapshots/endGetAccess/action",
"Microsoft.Compute/disks/read",
"Microsoft.Compute/disks/write",
"Microsoft.Compute/disks/delete",
"Microsoft.Compute/disks/beginGetAccess/action",
"Microsoft.Compute/disks/endGetAccess/action",
"Microsoft.Network/virtualNetworks/read",
"Microsoft.Network/virtualNetworks/subnets/join/action",
"Microsoft.Network/virtualNetworks/subnets/read",
"Microsoft.Network/networkSecurityGroups/read",
"Microsoft.Network/networkSecurityGroups/write",
"Microsoft.Network/networkSecurityGroups/delete",
"Microsoft.Network/networkSecurityGroups/join/action",
"Microsoft.Network/networkInterfaces/read",
"Microsoft.Network/networkInterfaces/write",
"Microsoft.Network/networkInterfaces/delete",
"Microsoft.Network/networkInterfaces/join/action",
<!--NeedCopy-->
Sono necessarie le seguenti autorizzazioni aggiuntive basate su autorizzazioni minime per le seguenti funzionalità:
-
Se l’immagine master è un disco rigido virtuale (VHD) in un account di archiviazione situato nella stessa area geografica della connessione host:
"Microsoft.Storage/storageAccounts/read", "Microsoft.Storage/storageAccounts/listKeys/action", <!--NeedCopy-->
-
Se l’immagine master è una ImageVersion della Raccolta immagini condivise:
"Microsoft.Compute/galleries/read", "Microsoft.Compute/galleries/images/read", "Microsoft.Compute/galleries/images/versions/read", <!--NeedCopy-->
-
Se l’immagine master è un disco gestito, le snapshot o il VHD si trovano in una regione diversa dalla regione della connessione di hosting:
"Microsoft.Storage/storageAccounts/read", "Microsoft.Storage/storageAccounts/listKeys/action", "Microsoft.Storage/storageAccounts/write", "Microsoft.Storage/storageAccounts/delete", <!--NeedCopy-->
-
Se si utilizza un gruppo di risorse gestito da Citrix:
"Microsoft.Resources/subscriptions/resourceGroups/write", "Microsoft.Resources/subscriptions/resourceGroups/delete", <!--NeedCopy-->
-
Se si colloca l’immagine master nella Raccolta immagini condivise:
"Microsoft.Compute/galleries/write", "Microsoft.Compute/galleries/images/write", "Microsoft.Compute/galleries/images/versions/write", "Microsoft.Compute/galleries/read", "Microsoft.Compute/galleries/images/read", "Microsoft.Compute/galleries/images/versions/read", "Microsoft.Compute/galleries/delete", "Microsoft.Compute/galleries/images/delete", "Microsoft.Compute/galleries/images/versions/delete", <!--NeedCopy-->
-
Se si utilizza il supporto degli host dedicati di Azure:
"Microsoft.Compute/hostGroups/read", "Microsoft.Compute/hostGroups/write", "Microsoft.Compute/hostGroups/hosts/read", <!--NeedCopy-->
-
Se si utilizza la crittografia lato server (SSE) con le chiavi gestite dal cliente (CMK):
"Microsoft.Compute/diskEncryptionSets/read", <!--NeedCopy-->
-
Se si distribuiscono macchine virtuali utilizzando modelli ARM (profilo macchina):
"Microsoft.Resources/deployments/write", "Microsoft.Resources/deployments/operationstatuses/read", "Microsoft.Resources/deployments/read", "Microsoft.Resources/deployments/delete", <!--NeedCopy-->
-
Se si utilizza la specifica del modello di Azure come profilo macchina:
"Microsoft.Resources/templateSpecs/read", "Microsoft.Resources/templateSpecs/versions/read", <!--NeedCopy-->
Creazione, aggiornamento ed eliminazione di macchine con disco non gestito
Di seguito è riportato l’elenco delle autorizzazioni minime richieste quando l’immagine master è un VHD e utilizza il gruppo di risorse come fornito dall’amministratore:
"Microsoft.Resources/subscriptions/resourceGroups/read",
"Microsoft.Storage/storageAccounts/delete",
"Microsoft.Storage/storageAccounts/listKeys/action",
"Microsoft.Storage/storageAccounts/read",
"Microsoft.Storage/storageAccounts/write",
"Microsoft.Compute/virtualMachines/deallocate/action",
"Microsoft.Compute/virtualMachines/delete",
"Microsoft.Compute/virtualMachines/read",
"Microsoft.Compute/virtualMachines/write",
"Microsoft.Resources/deployments/validate/action",
"Microsoft.Network/networkInterfaces/delete",
"Microsoft.Network/networkInterfaces/join/action",
"Microsoft.Network/networkInterfaces/read",
"Microsoft.Network/networkInterfaces/write",
"Microsoft.Network/networkSecurityGroups/delete",
"Microsoft.Network/networkSecurityGroups/join/action",
"Microsoft.Network/networkSecurityGroups/read",
"Microsoft.Network/networkSecurityGroups/write",
"Microsoft.Network/virtualNetworks/subnets/read",
"Microsoft.Network/virtualNetworks/read",
"Microsoft.Network/virtualNetworks/subnets/join/action"
<!--NeedCopy-->
Autorizzazione generale
Il ruolo di collaboratore ha accesso completo per gestire tutte le risorse. Questo set di autorizzazioni non impedisce di ottenere nuove funzionalità.
Il seguente set di autorizzazioni fornisce la migliore compatibilità in futuro, sebbene includa più autorizzazioni del necessario con il set di funzionalità corrente:
"Microsoft.Compute/diskEncryptionSets/read",
"Microsoft.Compute/disks/beginGetAccess/action",
"Microsoft.Compute/disks/delete",
"Microsoft.Compute/disks/endGetAccess/action",
"Microsoft.Compute/disks/read",
"Microsoft.Compute/disks/write",
"Microsoft.Compute/galleries/delete",
"Microsoft.Compute/galleries/images/delete",
"Microsoft.Compute/galleries/images/read",
"Microsoft.Compute/galleries/images/versions/delete",
"Microsoft.Compute/galleries/images/versions/read",
"Microsoft.Compute/galleries/images/versions/write",
"Microsoft.Compute/galleries/images/write",
"Microsoft.Compute/galleries/read",
"Microsoft.Compute/galleries/write",
"Microsoft.Compute/hostGroups/hosts/read",
"Microsoft.Compute/hostGroups/read",
"Microsoft.Compute/hostGroups/write",
"Microsoft.Compute/snapshots/beginGetAccess/action",
"Microsoft.Compute/snapshots/delete",
"Microsoft.Compute/snapshots/endGetAccess/action",
"Microsoft.Compute/snapshots/read",
"Microsoft.Compute/snapshots/write",
"Microsoft.Compute/virtualMachines/deallocate/action",
"Microsoft.Compute/virtualMachines/delete",
"Microsoft.Compute/virtualMachines/read",
"Microsoft.Compute/virtualMachines/restart/action",
"Microsoft.Compute/virtualMachines/start/action",
"Microsoft.Compute/virtualMachines/write",
"Microsoft.Network/networkInterfaces/delete",
"Microsoft.Network/networkInterfaces/join/action",
"Microsoft.Network/networkInterfaces/read",
"Microsoft.Network/networkInterfaces/write",
"Microsoft.Network/networkSecurityGroups/delete",
"Microsoft.Network/networkSecurityGroups/join/action",
"Microsoft.Network/networkSecurityGroups/read",
"Microsoft.Network/networkSecurityGroups/write",
"Microsoft.Network/virtualNetworks/subnets/read",
"Microsoft.Network/virtualNetworks/read",
"Microsoft.Network/virtualNetworks/subnets/join/action",
"Microsoft.Resources/deployments/operationstatuses/read",
"Microsoft.Resources/deployments/read",
"Microsoft.Resources/deployments/validate/action",
"Microsoft.Resources/deployments/write",
"Microsoft.Resources/deployments/delete",
"Microsoft.Resources/subscriptions/resourceGroups/read",
"Microsoft.Resources/subscriptions/resourceGroups/write",
"Microsoft.Resources/subscriptions/resourceGroups/delete",
"Microsoft.Storage/storageAccounts/delete",
"Microsoft.Storage/storageAccounts/listKeys/action",
"Microsoft.Storage/storageAccounts/read",
"Microsoft.Storage/storageAccounts/write",
"Microsoft.Resources/templateSpecs/read",
"Microsoft.Resources/templateSpecs/versions/read",
<!--NeedCopy-->
Configurare le autorizzazioni di connessione host di Azure richieste
Si possono configurare facilmente tutte le autorizzazioni minime richieste per un’entità di servizio o un account utente in Azure collegato a una connessione host per eseguire tutte le operazioni MCS utilizzando un modello ARM. Questo modello ARM automatizza quanto segue:
- Creazione di un ruolo di Azure con le autorizzazioni minime necessarie per le operazioni.
- Assegnazione di questo ruolo a un’entità di servizio di Azure esistente a livello di sottoscrizione.
È possibile distribuire questo modello ARM utilizzando il portale di Azure o i comandi PowerShell. Per ulteriori informazioni, vedere Modello ARM per le operazioni CVAD.
Passaggi successivi
- Se ci si trova nel processo di distribuzione iniziale, vedere Creare cataloghi delle macchine
- Per informazioni specifiche su Azure, vedere Creare un catalogo di Microsoft Azure