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

New-AzStorageContainer

创建 Azure 存储容器。

语法

ContainerName (默认值)

New-AzStorageContainer
    [-Name] <String>
    [[-Permission] <BlobContainerPublicAccessType>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

EncryptionScope

New-AzStorageContainer
    [-Name] <String>
    [[-Permission] <BlobContainerPublicAccessType>]
    -DefaultEncryptionScope <String>
    -PreventEncryptionScopeOverride <Boolean>
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

说明

New-AzStorageContainer cmdlet 创建 Azure 存储容器。

示例

示例 1:创建 Azure 存储容器

New-AzStorageContainer -Name "ContainerName" -Permission Off

此命令创建存储容器。

示例 2:创建多个 Azure 存储容器

"container1 container2 container3".split() | New-AzStorageContainer -Permission Container

此示例创建多个存储容器。 它使用 .NET String 类的 Split 方法,然后在管道上传递名称。

示例 3:使用加密范围创建 Azure 存储容器

$container = New-AzStorageContainer  -Name "mycontainer" -DefaultEncryptionScope "myencryptscope" -PreventEncryptionScopeOverride $true

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

此命令创建一个存储容器,默认加密范围为 myencryptscope,并阻止将具有不同加密作用域的 Blob 上传到此容器。

参数

-ClientTimeoutPerRequest

指定一个服务请求的客户端超时间隔(以秒为单位)。 如果上一次调用在指定的时间间隔内失败,则此 cmdlet 将重试请求。 如果此 cmdlet 在间隔过前未收到成功的响应,则此 cmdlet 将返回错误。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:ClientTimeoutPerRequestInSeconds

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConcurrentTaskCount

指定最大并发网络调用数。 可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。 指定的值是绝对计数,不乘以核心计数。 此参数可帮助减少低带宽环境中的网络连接问题,例如每秒 100 千比特。 默认值为 10。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Context

指定新容器的上下文。

参数属性

类型:IStorageContext
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DefaultEncryptionScope

将容器默认为所有写入使用指定的加密范围。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

EncryptionScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

指定新容器的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:N, 集装箱

参数集

(All)
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Permission

指定对此容器的公共访问级别。 默认情况下,容器及其中的任何 blob 只能由存储帐户的所有者访问。 若要向匿名用户授予对容器及其 Blob 的读取权限,可以设置容器权限以启用公共访问。 匿名用户可以读取公开可用的容器中的 Blob,而无需对请求进行身份验证。 此参数的可接受值为:

  • 容器。 提供对容器及其 Blob 的完整读取访问权限。 客户端可以通过匿名请求枚举容器中的 blob,但不能枚举存储帐户中的容器。
  • Blob。 通过匿名请求在整个容器中提供对 Blob 数据的读取访问权限,但不提供对容器数据的访问。 客户端无法使用匿名请求枚举容器中的 blob。
  • 禁用。 这会仅限制对存储帐户所有者的访问。

参数属性

类型:

Nullable<T>[Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType]

默认值:None
接受的值:Off, Container, Blob, Unknown
支持通配符:False
不显示:False
别名:PublicAccess

参数集

(All)
Position:1
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PreventEncryptionScopeOverride

阻止从容器默认值替代加密范围。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

EncryptionScope
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ServerTimeoutPerRequest

指定请求的服务端超时间隔(以秒为单位)。 如果服务处理请求之前指定的间隔已过,则存储服务将返回错误。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:ServerTimeoutPerRequestInSeconds

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

IStorageContext

输出

AzureStorageContainer