New-AzStorageContainer

  • リファレンス
モジュール:
Az.Storage

Azure ストレージ コンテナーを作成します。

構文

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

説明

New-AzStorageContainer コマンドレットは、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

1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。

型:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConcurrentTaskCount

同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Context

新しいコンテナーのコンテキストを指定します。

型:IStorageContext
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultEncryptionScope

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

新しいコンテナーの名前を指定します。

型:String
Aliases:N, Container
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Permission

このコンテナーへのパブリック アクセスのレベルを指定します。 既定では、コンテナーとその中のすべての BLOB には、ストレージ アカウントの所有者のみがアクセスできます。 匿名ユーザーにコンテナーとその BLOB への読み取りアクセス許可を付与するには、コンテナーのアクセス許可を設定してパブリック アクセスを有効にすることができます。 匿名ユーザーは、要求を認証することなく、パブリックに使用可能なコンテナー内の BLOB を読み取ることができます。 このパラメーターの有効値は、次のとおりです。

  • [コンテナー]。 コンテナーとその BLOB への完全な読み取りアクセスを提供します。 クライアントは匿名要求を通じてコンテナー内の BLOB を列挙できますが、ストレージ アカウント内のコンテナーを列挙することはできません。
  • ブロッブ。 匿名要求を介してコンテナー全体で BLOB データへの読み取りアクセスを提供しますが、コンテナー データへのアクセスは提供しません。 クライアントは、匿名要求を使用してコンテナー内の BLOB を列挙できません。
  • オフ。 ストレージ アカウントの所有者のみにアクセスを制限します。
型:Nullable<T>[BlobContainerPublicAccessType]
Aliases:PublicAccess
指定可能な値:Off, Container, Blob, Unknown
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PreventEncryptionScopeOverride

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

型:Boolean
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerTimeoutPerRequest

要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。

型:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

IStorageContext

出力

AzureStorageContainer