你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzureStorageContext

参考

模块:: Azure.Storage

创建 Azure 存储上下文。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器（ARM）资源。

语法

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 存储上下文。

类型:	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

指定允许用于使用帐户 SAS 发出的请求的协议。此参数的可接受值为：

HttpsOnly
HttpsOrHttp

默认值为 HttpsOrHttp。

类型:	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

输出

AzureStorageContext

通过