New-AzStorageContainer

  • 參考
模組:
Az.Storage

建立 Azure 儲存體容器。

Syntax

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>]

Description

New-Az 儲存體 Container 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 會傳回錯誤。

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限，使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數，不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題，例如每秒 100 千位。 預設值為 10。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

指定新容器的內容。

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定新容器的名稱。

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

-Permission

指定此容器的公用存取層級。 根據預設，容器和其中的任何 Blob 只能由記憶體帳戶的擁有者存取。 若要將匿名使用者讀取許可權授與容器及其 Blob，您可以設定容器許可權以啟用公用存取。 匿名使用者可以讀取公開可用的容器中的 Blob，而不需驗證要求。 此參數可接受的值為：

  • 容器。 提供容器及其 Blob 的完整讀取許可權。 用戶端可以透過匿名要求列舉容器中的 Blob，但無法列舉記憶體帳戶中的容器。
  • Blob。 透過匿名要求提供整個容器 Blob 數據的讀取許可權，但不會提供容器數據的存取權。 用戶端無法使用匿名要求列舉容器中的 Blob。
  • 關閉。 這會限制只能存取記憶體帳戶擁有者。
Type:Nullable<T>[BlobContainerPublicAccessType]
Aliases:PublicAccess
Accepted values:Off, Container, Blob, Unknown
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreventEncryptionScopeOverride

封鎖從容器預設值覆寫加密範圍。

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

-ServerTimeoutPerRequest

指定要求的服務端超時時間間隔，以秒為單位。 如果指定的間隔在服務處理要求之前經過，則記憶體服務會傳回錯誤。

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

IStorageContext

輸出

AzureStorageContainer