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

New-AzRmStorageContainer

参考

模块:: Az.Storage

创建存储 Blob 容器

语法

New-AzRmStorageContainer
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Name <String>
   [-PublicAccess <PSPublicAccess>]
   [-Metadata <Hashtable>]
   [-RootSquash <String>]
   [-EnableImmutableStorageWithVersioning]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzRmStorageContainer
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Name <String>
   -DefaultEncryptionScope <String>
   -PreventEncryptionScopeOverride <Boolean>
   [-PublicAccess <PSPublicAccess>]
   [-Metadata <Hashtable>]
   [-RootSquash <String>]
   [-EnableImmutableStorageWithVersioning]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzRmStorageContainer
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-PublicAccess <PSPublicAccess>]
   [-Metadata <Hashtable>]
   [-RootSquash <String>]
   [-EnableImmutableStorageWithVersioning]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzRmStorageContainer
   -StorageAccount <PSStorageAccount>
   -Name <String>
   -DefaultEncryptionScope <String>
   -PreventEncryptionScopeOverride <Boolean>
   [-PublicAccess <PSPublicAccess>]
   [-Metadata <Hashtable>]
   [-RootSquash <String>]
   [-EnableImmutableStorageWithVersioning]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzRmStorageContainer cmdlet 创建存储 blob 容器

示例

示例 1：使用存储帐户名称和容器名称创建包含元数据的存储 Blob 容器

New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -Metadata @{tag0="value0";tag1="value1";tag2="value2"}

此命令使用存储帐户名称和容器名称创建存储 Blob 容器，其中包含元数据。

示例 2：使用存储帐户对象和容器名称创建存储 Blob 容器，公共访问权限为 Blob

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
New-AzRmStorageContainer -StorageAccount $accountObject -ContainerName "myContainer" -PublicAccess Blob

此命令创建一个存储 Blob 容器，其中包含存储帐户对象和容器名称，公共访问权限为 Blob。

示例 3：使用 EncryptionScope 设置创建存储容器

$c = New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "mystorageaccount" -Name testcontainer -DefaultEncryptionScope "testscope" -PreventEncryptionScopeOverride $true

$c

   ResourceGroupName: myResourceGroup, StorageAccountName: mystorageaccount

Name          PublicAccess LastModified HasLegalHold HasImmutabilityPolicy
----          ------------ ------------ ------------ ---------------------
testcontainer                           False        False                

$c.DefaultEncryptionScope
testscope

$c.DenyEncryptionScopeOverride
True

此命令使用 defalt encryptionScope 创建存储容器，并阻止从容器默认值替代加密范围。然后显示相关的容器属性。

示例 4：使用 RootSquash 创建 Azure 存储容器

$container = New-AzRmStorageContainer -ResourceGroupName "myersourcegroup" -AccountName "mystorageaccount" -Name "mycontainer" -RootSquash AllSquash

$container.EnableNfsV3AllSquash
True

$container.EnableNfsV3RootSquash
False

此命令创建存储容器，将 RootSquash 属性设置为 AllSquash。 RootSquash 仅适用于启用了 NfsV3 的存储帐户。

示例 5：创建存储容器并使用版本控制启用不可变存储

$c = New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "mystorageaccount" -Name testcontainer -EnableImmutableStorageWithVersioning

$c

ResourceGroupName: myResourceGroup, StorageAccountName: mystorageaccount

Name          PublicAccess LastModified         HasLegalHold HasImmutabilityPolicy Deleted VersionId ImmutableStorageWithVersioning
----          ------------ ------------         ------------ --------------------- ------- --------- ------------------------------
testcontainer None         2021-07-19 08:26:19Z False        False                 False             True

此命令创建存储容器，并使用版本控制启用不可变存储。仅当存储帐户已启用 Blob 版本控制时，该命令才有效。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultEncryptionScope

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableImmutableStorageWithVersioning

使用容器级别的版本控制启用不可变存储。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Metadata

容器元数据

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

容器名称

类型:	String
别名:	N, ContainerName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PreventEncryptionScopeOverride

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

类型:	Boolean
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PublicAccess

容器 PublicAccess

类型:	PSPublicAccess
接受的值:	Container, Blob, None
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-RootSquash

设置远程超级用户的访问权限减少。可能的值包括：“NoRootSquash”、“RootSquash”、“AllSquash”

类型:	String
接受的值:	NoRootSquash, RootSquash, AllSquash
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageAccount

存储帐户对象

类型:	PSStorageAccount
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-StorageAccountName

存储帐户名称。

类型:	String
别名:	AccountName
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

PSStorageAccount

输出

PSContainer

通过