你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzureStorageContext
创建 Azure 存储上下文。
注意
本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 Az PowerShell 模块。
语法
New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
-ConnectionString <String>
[<CommonParameters>]
New-AzureStorageContext
[-Local]
[<CommonParameters>]
说明
New-AzureStorageContext cmdlet 创建 Azure 存储上下文。
示例
示例 1:通过指定存储帐户名称和密钥创建上下文
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
此命令为使用指定密钥的名为 ContosoGeneral 的帐户创建上下文。
示例 2:通过指定连接字符串创建上下文
C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"
此命令基于帐户 ContosoGeneral 的指定连接字符串创建上下文。
示例 3:为匿名存储帐户创建上下文
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"
此命令为名为 ContosoGeneral 的帐户创建匿名使用的上下文。 该命令将 HTTP 指定为连接协议。
示例 4:使用本地开发存储帐户创建上下文
C:\PS>New-AzureStorageContext -Local
此命令使用本地开发存储帐户创建上下文。 该命令指定 Local 参数。
示例 5:获取本地开发人员存储帐户的容器
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainer
此命令使用本地开发存储帐户创建上下文,然后使用管道运算符将新上下文 传递到 Get-AzureStorageContainer cmdlet。 该命令获取本地开发人员存储帐户的 Azure 存储容器。
示例 6:获取多个容器
C:\PS>$Context01 = New-AzureStorageContext -Local
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer
第一个命令使用本地开发存储帐户创建上下文,然后将该上下文存储在 $Context 01 变量中。
第二个命令为名为 ContosoGeneral 的帐户创建一个上下文,该帐户使用指定的键,然后将该上下文存储在 $Context 02 变量中。
最后一个命令使用 Get-AzureStorageContainer 获取存储在 $Context 01 和 $Context 02 中的上下文的容器。
示例 7:使用终结点创建上下文
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"
此命令创建具有指定存储终结点的 Azure 存储上下文。 该命令为使用指定密钥的名为 ContosoGeneral 的帐户创建上下文。
示例 8:创建具有指定环境的上下文
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"
此命令创建具有指定 Azure 环境的 Azure 存储上下文。 该命令为使用指定密钥的名为 ContosoGeneral 的帐户创建上下文。
示例 9:使用 SAS 令牌创建上下文
C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "raud"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"
第一个命令使用名为 ContosoMain 的容器的 New-AzureStorageContainerSASToken cmdlet 生成 SAS 令牌,然后将该令牌存储在$SasToken变量中。 该令牌用于读取、添加、更新和删除权限。
第二个命令为名为 ContosoGeneral 的帐户创建一个上下文,该帐户使用存储在$SasToken中的 SAS 令牌,然后将该上下文存储在$Context变量中。
最后一个命令使用存储在$Context中的上下文列出与名为 ContosoMain 的容器关联的所有 blob。
参数
-Anonymous
指示此 cmdlet 创建用于匿名登录的 Azure 存储上下文。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionString
指定 Azure 存储上下文的连接字符串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Endpoint
指定 Azure 存储上下文的终结点。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Environment
指定 Azure 环境。
此参数的可接受值为:AzureCloud 和 AzureChinaCloud。
有关详细信息,请键入 Get-Help Get-AzureEnvironment
。
Type: | String |
Aliases: | Name, EnvironmentName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Local
指示此 cmdlet 使用本地开发存储帐户创建上下文。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
指定允许用于使用帐户 SAS 发出的请求的协议。 此参数的可接受值为:
- HttpsOnly
- HttpsOrHttp
默认值为 HttpsOrHttp。
Type: | String |
Accepted values: | Http, Https |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SasToken
为上下文指定共享访问签名 (SAS) 令牌。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StorageAccountKey
指定 Azure 存储帐户密钥。 此 cmdlet 为此参数指定的键创建上下文。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StorageAccountName
指定 Azure 存储帐户名称。 此 cmdlet 为此参数指定的帐户创建上下文。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输出
AzureStorageContext