New-AzStorageContainer
建立 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>]
Description
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] |
別名: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ConcurrentTaskCount
指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限,使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數,不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題,例如每秒 100 千位。 預設值為 10。
類型: | Nullable<T>[Int32] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Context
指定新容器的內容。
類型: | IStorageContext |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DefaultEncryptionScope
默認為容器,以針對所有寫入使用指定的加密範圍。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定新容器的名稱。
類型: | String |
別名: | N, Container |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Permission
指定此容器的公用存取層級。 根據預設,容器和其中的任何 Blob 只能由記憶體帳戶的擁有者存取。 若要將匿名使用者讀取許可權授與容器及其 Blob,您可以設定容器許可權以啟用公用存取。 匿名使用者可以讀取公開可用的容器中的 Blob,而不需驗證要求。 此參數可接受的值為:
- 容器。 提供容器及其 Blob 的完整讀取許可權。 用戶端可以透過匿名要求列舉容器中的 Blob,但無法列舉記憶體帳戶中的容器。
- Blob。 透過匿名要求提供整個容器 Blob 數據的讀取許可權,但不會提供容器數據的存取權。 用戶端無法使用匿名要求列舉容器中的 Blob。
- 關閉。 這會限制只能存取記憶體帳戶擁有者。
類型: | Nullable<T>[BlobContainerPublicAccessType] |
別名: | PublicAccess |
接受的值: | Off, Container, Blob, Unknown |
Position: | 1 |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PreventEncryptionScopeOverride
封鎖從容器預設值覆寫加密範圍。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ServerTimeoutPerRequest
指定要求的服務端超時時間間隔,以秒為單位。 如果指定的間隔在服務處理要求之前經過,則記憶體服務會傳回錯誤。
類型: | Nullable<T>[Int32] |
別名: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |