New-AzRmStorageContainer

ストレージ 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 コマンドレットは、ストレージ 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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultEncryptionScope

既定では、すべての書き込みに指定された暗号化スコープを使用するコンテナーです。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableImmutableStorageWithVersioning

コンテナー レベルでバージョン管理を使用して不変ストレージを有効にします。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Metadata

コンテナー メタデータ

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

コンテナー名

Type:String
Aliases:N, ContainerName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PreventEncryptionScopeOverride

コンテナーの既定値からの暗号化スコープのオーバーライドをブロックします。

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicAccess

Container PublicAccess

Type:PSPublicAccess
Accepted values:Container, Blob, None
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソース グループ名。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RootSquash

リモート スーパーユーザーのアクセス権の削減を設定します。 使用可能な値は、'NoRootSquash'、'RootSquash'、'AllSquash' です。

Type:String
Accepted values:NoRootSquash, RootSquash, AllSquash
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccount

ストレージ アカウント オブジェクト

Type:PSStorageAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

ストレージ アカウント名。

Type:String
Aliases:AccountName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

PSStorageAccount

出力

PSContainer