你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureStorageContext
创建 Azure 存储上下文。
警告
AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可运行，但不再受到维护或支持，任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] 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
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <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 "rad"
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。
示例 10：使用 OAuth 身份验证创建上下文
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount此命令使用 OAuth 身份验证创建上下文。
参数
-Anonymous
指示此 cmdlet 为匿名登录创建Azure 存储上下文。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ConnectionString
指定Azure 存储上下文的连接字符串。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Endpoint
指定Azure 存储上下文的终结点。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Environment
指定 Azure 环境。
此参数的可接受值为：AzureCloud 和 AzureChinaCloud。
要了解详情，请键入 Get-Help Get-AzureEnvironment。
| 类型: | String |
| 别名: | Name, EnvironmentName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Local
指示此 cmdlet 使用本地开发存储帐户创建上下文。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Protocol
传输协议（https/http）。
| 类型: | String |
| 接受的值: | Http, Https |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SasToken
为上下文指定共享访问签名 （SAS） 令牌。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-StorageAccountKey
指定Azure 存储帐户密钥。 此 cmdlet 为此参数指定的键创建上下文。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-StorageAccountName
指定Azure 存储帐户名称。 此 cmdlet 为此参数指定的帐户创建上下文。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-UseConnectedAccount
指示此 cmdlet 使用 OAuth 身份验证创建Azure 存储上下文。 如果未指定其他身份验证，则 cmdlet 默认使用 OAuth 身份验证。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |