使用 PowerShell 管理 Azure 独立云中的存储
大多数人为其全球 Azure 部署使用了 Azure 公有云。 但出于主权等方面的原因,还存在一些独立的 Azure 部署。 这些独立部署称为“环境”。以下列表详细介绍了当前可用的独立云。
注意
建议使用 Azure Az PowerShell 模块与 Azure 交互。 请参阅安装 Azure PowerShell 以开始使用。 若要了解如何迁移到 Az PowerShell 模块,请参阅 将 Azure PowerShell 从 AzureRM 迁移到 Az。
使用独立云
若要在某个独立云中使用 Azure 存储,需要连接到该云而不是 Azure 公有云。 若要使用某个独立云而不是 Azure 公有云,需要:
- 指定要连接到的环境。
- 确定并使用可用的区域。
- 使用正确的终结点后缀,它不同于 Azure 公有云。
本文中的示例需要 Azure PowerShell 模块 Az 版本 0.7 或更高版本。 在 PowerShell 窗口中,运行 Get-Module -ListAvailable Az
可查找版本。 如果未列出任何信息或需要升级,请参阅安装 Azure PowerShell 模块。
登录 Azure
运行 Get-AzEnvironment cmdlet 以查看可用的 Azure 环境:
Get-AzEnvironment
登录到有权访问所要连接的云的帐户,并设置环境。 此示例演示如何登录到使用由世纪互联运营的 Microsoft Azure 的帐户。
Connect-AzAccount -Environment AzureChinaCloud
此时,如果需要查看可在其中创建存储帐户或其他资源的位置列表,可以使用 Get-AzLocation 查询所选云可用的位置。
Get-AzLocation | select Location, DisplayName
下表显示了针对中国云返回的位置。
位置 | 显示名称 |
---|---|
chinanorth 3 | 中国北部 3 |
chinaeast | 中国东部 |
chinaeast 2 | 中国东部 2 |
chinanorth | 中国北部 |
chinanorth 2 | 中国北部 2 |
终结点后缀
其中每个环境的终结点后缀不同于 Azure 公有云终结点。 例如,Azure 公有云的 Blob 终结点后缀为 blob.core.windows.net。 对于中国云,Blob 终结点后缀为 blob.core.chinacloudapi.cn。
使用 Get-AzEnvironment 获取终结点
使用 Get-AzEnvironment 检索终结点后缀。 终结点是环境的 StorageEndpointSuffix 属性。
下面的代码片段演示如何检索终结点后缀。 所有这些命令返回类似于“core.chinacloudapi.cn”的内容。 将此后缀追加到存储服务即可访问该服务。 例如,追加“queue.core.chinacloudapi.cn”可访问中国云中的队列服务。
此代码片段检索所有环境,以及每个环境的终结点后缀。
Get-AzEnvironment | select Name, StorageEndpointSuffix
此命令返回以下结果。
名称 | core.usgovcloudapi.net |
---|---|
AzureChinaCloud | core.chinacloudapi.cn |
AzureCloud | core.windows.net |
AzureGermanCloud | core.cloudapi.de |
AzureUSGovernment | core.usgovcloudapi.net |
若要检索指定环境的所有属性,请调用 Get-AzEnvironment 并指定云名称。 此代码片段返回属性列表;请在列表中查找 StorageEndpointSuffix。 以下示例适用于中国云。
Get-AzEnvironment -Name AzureChinaCloud
结果类似于以下值:
属性名称 | Value |
---|---|
名称 | AzureChinaCloud |
EnableAdfsAuthentication | False |
ActiveDirectoryServiceEndpointResourceI | https://management.core.chinacloudapi.cn/ |
GalleryURL | https://gallery.cloudapi.de/ |
ManagementPortalUrl | https://portal.azure.cn |
ServiceManagementUrl | https://management.core.chinacloudapi.cn/ |
PublishSettingsFileUrl | https://go.microsoft.com/fwlink/?LinkID=301776 |
ResourceManagerUrl | https://management.chinacloudapi.cn/ |
SqlDatabaseDnsSuffix | .database.chinacloudapi.cn |
StorageEndpointSuffix | core.chinacloudapi.cn |
... | ... |
若只要检索存储终结点后缀属性,请检索特定的云,并仅请求该属性。
$environment = Get-AzEnvironment -Name AzureChinaCloud
Write-Host "Storage EndPoint Suffix = " $environment.StorageEndpointSuffix
此命令返回以下信息:
Storage Endpoint Suffix = core.chinacloudapi.cn
从存储帐户获取终结点
还可以通过检查存储帐户的属性来检索终结点:
# 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
对于中国云中的存储帐户,此命令返回以下输出:
blob endpoint = http://myexistingstorageaccount.blob.core.chinacloudapi.cn/
file endpoint = http://myexistingstorageaccount.file.core.chinacloudapi.cn/
queue endpoint = http://myexistingstorageaccount.queue.core.chinacloudapi.cn/
table endpoint = http://myexistingstorageaccount.table.core.chinacloudapi.cn/
设置环境之后
现在可以使用 PowerShell 来管理存储帐户并访问 blob、队列、文件和表数据。 有关详细信息,请参阅 Az.Storage。
清理资源
如果为本练习创建了新的资源组和存储帐户,可以通过删除资源组来删除这两个资产。 删除资源组会删除其包含的所有资源。
Remove-AzResourceGroup -Name $resourceGroup