New-AzStorageContext
建立 Azure 儲存體 內容。
語法
New-AzStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
-Environment <String>
[-EnableFileBackupRequestIntent]
[<CommonParameters>] New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-BlobEndpoint <String>
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>] New-AzStorageContext
-SasToken <String>
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>] New-AzStorageContext
-ConnectionString <String>
[<CommonParameters>] New-AzStorageContext
[-Local]
[<CommonParameters>] New-AzStorageContext
[-Anonymous]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>] New-AzStorageContext
[-UseConnectedAccount]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>] Description
New-AzStorageContext Cmdlet 會建立 Azure 儲存體 內容。 記憶體內容的預設驗證為 OAuth（Microsoft Entra ID），前提是只有輸入記憶體帳戶名稱。 請參閱 中的 https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services記憶體服務驗證詳細數據。
範例
範例 1：藉由指定記憶體帳戶名稱和金鑰來建立內容
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"此命令會針對使用指定索引鍵的帳戶建立名為 ContosoGeneral 的內容。
範例 2：藉由指定 連接字串 來建立內容
New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"此命令會根據 ContosoGeneral 帳戶的指定 連接字串 建立內容。
範例 3：建立匿名記憶體帳戶的內容
New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"此命令會為名為 ContosoGeneral 的帳戶建立匿名使用的內容。 命令會將 HTTP 指定為連線通訊協定。
範例 4：使用本機開發記憶體帳戶建立內容
New-AzStorageContext -Local此命令會使用本機開發記憶體帳戶來建立內容。 命令會 指定 Local 參數。
範例 5：取得本機開發人員記憶體帳戶的容器
New-AzStorageContext -Local | Get-AzStorageContainer此命令會使用本機開發記憶體帳戶建立內容，然後使用管線運算符將新內容傳遞至 Get-AzStorageContainer Cmdlet。 命令會取得本機開發人員記憶體帳戶的 Azure 儲存體 容器。
範例 6：取得多個容器
$Context01 = New-AzStorageContext -Local
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer第一個命令會使用本機開發記憶體帳戶來建立內容，然後將該內容儲存在 $Context 01 變數中。 第二個命令會建立名為 ContosoGeneral 的帳戶內容，該帳戶會使用指定的索引鍵，然後將該內容儲存在 $Context 02 變數中。 最後一個命令會使用 Get-AzStorageContainer 取得儲存在 $Context 01 和 $Context 02 的內容容器。
範例 7：使用端點建立內容
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"此命令會建立具有指定記憶體端點的 Azure 儲存體 內容。 命令會建立名為 ContosoGeneral 之帳戶的內容，該帳戶會使用指定的索引鍵。
範例 8：使用指定的環境建立內容
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"此命令會建立具有指定 Azure 環境的 Azure 記憶體內容。 命令會建立名為 ContosoGeneral 之帳戶的內容，該帳戶會使用指定的索引鍵。
範例 9：使用 SAS 令牌建立內容
$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"第一個命令會針對名為 ContosoMain 的容器使用 New-AzStorageContainerSASToken Cmdlet 來產生 SAS 令牌，然後將該令牌儲存在$SasToken變數中。 該令牌適用於讀取、新增、更新和刪除許可權。 第二個命令會針對名為 ContosoGeneral 的帳戶建立內容，該帳戶會使用儲存在 $SasToken 中的 SAS 令牌，然後將該內容儲存在 $Context 變數中。 最後一個命令會使用儲存在 $Context 中的內容，列出與名為 ContosoMain 之容器相關聯的所有 Blob。
範例 10：使用 OAuth 驗證建立內容
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount此命令會使用 OAuth 建立內容（Microsoft Entra ID） 驗證。
範例 11：藉由指定記憶體帳戶名稱、記憶體帳戶密鑰和自定義 Blob 端點來建立內容
New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"此命令會為名為 myaccountname 的帳戶建立內容，其中包含帳戶的密鑰，以及指定的 Blob 端點。
範例 12：為具有指定 Blob 端點的匿名記憶體帳戶建立內容
New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"此命令會針對名為 myaccountname 的帳戶，使用指定的 Blob enpoint，建立匿名使用的內容。
範例 13：使用具有指定端點的 SAS 令牌建立內容
$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
New-AzStorageContext -SasToken $SasToken -BlobEndpoint "https://myaccountname.blob.core.windows.net/" -TableEndpoint "https://myaccountname.table.core.windows.net/" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"第一個命令會針對名為 MyContainer 的容器使用 New-AzStorageContainerSASToken Cmdlet 來產生 SAS 令牌，然後將該令牌儲存在$SasToken變數中。 第二個命令會建立使用 SAS 令牌和指定 Blob 端點、數據表端點、檔案端點和佇列端點的內容。
範例 14：使用 OAuth 驗證搭配指定的 Blob 端點建立內容
New-AzStorageContext -UseConnectedAccount -BlobEndpoint "https://myaccountname.blob.core.windows.net/"此命令會使用 OAuth 驗證搭配指定的 Blob 端點來建立內容。
範例 15：在檔案服務上使用 OAuth 驗證建立內容
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent此命令會建立內容，以在檔案服務上使用 OAuth （Microsoft Entra ID） 驗證。 需要參數 '-EnableFileBackupRequestIntent' 才能使用檔案服務的 OAuth （Microsoft Entra ID） 驗證。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。
參數
-Anonymous
指出此 Cmdlet 會為匿名登錄建立 Azure 儲存體 內容。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-BlobEndpoint
Azure 記憶體 Blob 服務端點
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ConnectionString
指定 Azure 儲存體 內容的 連接字串。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableFileBackupRequestIntent
與 OAuth 搭配使用的必要參數 （Microsoft Entra ID） 驗證檔案。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Endpoint
指定 Azure 儲存體 內容的端點。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Environment
指定 Azure 環境。
此參數可接受的值為：AzureCloud 和 AzureChinaCloud。
如需詳細資訊，請輸入 Get-Help Get-AzEnvironment。
| 類型: | String |
| 別名: | Name, EnvironmentName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-FileEndpoint
Azure 記憶體檔案服務端點
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Local
表示此 Cmdlet 會使用本機開發記憶體帳戶來建立內容。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Protocol
傳輸通訊協議（HTTPs/HTTP）。
| 類型: | String |
| 接受的值: | Http, Https |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-QueueEndpoint
Azure 記憶體佇列服務端點
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SasToken
指定內容的共享存取簽章 （SAS） 令牌。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-StorageAccountKey
指定 Azure 儲存體 帳戶金鑰。 這個 Cmdlet 會為此參數指定的索引鍵建立內容。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-StorageAccountName
指定 Azure 儲存體 帳戶名稱。 這個 Cmdlet 會為此參數指定的帳戶建立內容。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TableEndpoint
Azure 記憶體數據表服務端點
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UseConnectedAccount
指出此 Cmdlet 會使用 OAuth 建立 Azure 儲存體 內容（Microsoft Entra ID） 驗證。 Cmdlet 預設會在未指定其他驗證時使用 OAuth 驗證。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
