Gestion du stockage dans les clouds indépendants Azure avec PowerShell

2023-05-11

La plupart des gens utilisent le cloud public Azure pour leur déploiement Azure global. Pour des raisons de souveraineté, entre autres, il existe également des déploiements indépendants de Microsoft Azure. Ces déploiements indépendants sont appelés « environnements ». La liste suivante détaille les clouds indépendants actuellement disponibles.

Notes

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Utilisation d’un cloud indépendant

Pour utiliser le stockage Azure dans l’un des clouds indépendants, vous vous connectez à ce cloud au lieu du cloud Azure public. Pour utiliser l’un des clouds indépendants plutôt que le cloud Azure public :

Spécifiez l’environnement auquel se connecter.
Déterminez et utilisez les régions disponibles.
Utilisez le suffixe de point de terminaison approprié, qui est différent de celui du cloud Azure public.

Ces exemples nécessitent le module Az Azure PowerShell version 0.7 ou ultérieure. Dans une fenêtre PowerShell, exécutez Get-Module -ListAvailable Az pour trouver la version. Si aucune information ne s’affiche, ou si vous devez effectuer une mise à niveau, consultez Installer le module Azure PowerShell.

Connexion à Azure

Exécutez l’applet de commande Get-AzEnvironment pour voir les environnements Azure disponibles :

Get-AzEnvironment

Connectez-vous à votre compte qui a accès au cloud auquel vous souhaitez vous connecter, puis définissez l’environnement. Cet exemple montre comment se connecter à un compte qui utilise le cloud Azure Government.

Connect-AzAccount -Environment AzureUSGovernment

Pour accéder au cloud de la Chine, utilisez l’environnement AzureChinaCloud. Pour accéder au cloud allemand, utilisez AzureGermanCloud.

À ce stade, si vous avez besoin de la liste des emplacements pour créer un compte de stockage ou une autre ressource, vous pouvez interroger les emplacements disponibles pour le cloud sélectionné à l’aide de Get-AzLocation.

Get-AzLocation | select Location, DisplayName

Le tableau suivant présente les emplacements retournés pour le cloud allemand.

Emplacement	Nom d’affichage
`germanycentral`	Centre de l’Allemagne
`germanynortheast`	Nord-Est de l’Allemagne

Suffixe de point de terminaison

Le suffixe de point de terminaison pour chacun de ces environnements est différent de celui du point de terminaison du cloud Azure public. Par exemple, le suffixe de point de terminaison blob du cloud Azure public est blob.core.windows.net. Pour le cloud Government, le suffixe de point de terminaison blob est blob.core.usgovcloudapi.net.

Obtenir le point de terminaison avec Get-AzEnvironment

Récupérez le suffixe de point de terminaison à l’aide de Get-AzEnvironment. Le point de terminaison est la propriété StorageEndpointSuffix de l’environnement.

Les extraits de code suivants montrent comment récupérer le suffixe du point de terminaison. Toutes ces commandes retournent des valeurs similaires à « core.cloudapp.net» ou « core.cloudapi.de», etc. Ajoutez le suffixe au service de stockage pour accéder à ce dernier. Par exemple, « queue.core.cloudapi.de » accède au service de file d’attente du cloud allemand.

L’extrait de code suivant récupère tous les environnements et le suffixe de point de terminaison pour chacun d’eux.

Get-AzEnvironment | select Name, StorageEndpointSuffix

Cette commande retourne les résultats suivants.

Nom	StorageEndpointSuffix
AzureChinaCloud	core.chinacloudapi.cn
AzureCloud	core.windows.net
AzureGermanCloud	core.cloudapi.de
AzureUSGovernment	core.usgovcloudapi.net

Pour récupérer toutes les propriétés de l’environnement spécifié, appelez Get-AzEnvironment, puis spécifiez le nom du cloud. L’extrait de code suivant retourne une liste de propriétés. Recherchez StorageEndpointSuffix dans cette liste. L’exemple suivant concerne le cloud allemand.

Get-AzEnvironment -Name AzureGermanCloud

Les résultats sont semblables aux valeurs suivantes :

Nom de la propriété	Valeur
Nom	`AzureGermanCloud`
EnableAdfsAuthentication	`False`
ActiveDirectoryServiceEndpointResourceI	`http://management.core.cloudapi.de/`
GalleryURL	`https://gallery.cloudapi.de/`
ManagementPortalUrl	`https://portal.microsoftazure.de/`
ServiceManagementUrl	`https://manage.core.cloudapi.de/`
PublishSettingsFileUrl	`https://manage.microsoftazure.de/publishsettings/index`
ResourceManagerUrl	`http://management.microsoftazure.de/`
SqlDatabaseDnsSuffix	`.database.cloudapi.de`
StorageEndpointSuffix	`core.cloudapi.de`
...	...

Pour récupérer uniquement la propriété de suffixe de point de terminaison de stockage, récupérez le cloud spécifique, puis demandez juste cette propriété.

$environment = Get-AzEnvironment -Name AzureGermanCloud
Write-Host "Storage EndPoint Suffix = " $environment.StorageEndpointSuffix

Cette commande renvoie les informations suivantes :

Storage Endpoint Suffix = core.cloudapi.de

Obtenir le point de terminaison à partir d’un compte de stockage

Vous pouvez également consulter les propriétés d’un compte de stockage pour récupérer les points de terminaison :

# Get a reference to the storage account.
$resourceGroup = "myexistingresourcegroup"
$storageAccountName = "myexistingstorageaccount"
$storageAccount = Get-AzStorageAccount `
  -ResourceGroupName $resourceGroup `
  -Name $storageAccountName 
  # Output the endpoints.
Write-Host "blob endpoint = " $storageAccount.PrimaryEndPoints.Blob 
Write-Host "file endpoint = " $storageAccount.PrimaryEndPoints.File
Write-Host "queue endpoint = " $storageAccount.PrimaryEndPoints.Queue
Write-Host "table endpoint = " $storageAccount.PrimaryEndPoints.Table

Pour un compte de stockage dans le cloud Government, cette commande retourne la sortie suivante :

blob endpoint = http://myexistingstorageaccount.blob.core.usgovcloudapi.net/
file endpoint = http://myexistingstorageaccount.file.core.usgovcloudapi.net/
queue endpoint = http://myexistingstorageaccount.queue.core.usgovcloudapi.net/
table endpoint = http://myexistingstorageaccount.table.core.usgovcloudapi.net/

Après la configuration de l’environnement

Vous pouvez désormais utiliser PowerShell pour gérer vos comptes de stockage et accéder aux données d’objet BLOB, de file d’attente, de fichier et de table. Pour plus d’informations, consultez Az.Storage.

Nettoyer les ressources

Si vous avez créé un groupe de ressources et un compte de stockage pour cet exercice, vous pouvez supprimer les deux ressources en supprimant le groupe de ressources. La suppression du groupe de ressources supprime toutes les ressources qu’il contient.

Remove-AzResourceGroup -Name $resourceGroup

Partager via