New-AzStorageContext
語法
OAuthAccount (預設值)
New-AzStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKey
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AccountNameAndKeyEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-Environment <String>
[-Protocol <String>]
[<CommonParameters>]
AnonymousAccount
New-AzStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AnonymousAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-Anonymous]
[-Protocol <String>]
[<CommonParameters>]
SasToken
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
SasTokenWithAzureEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>]
OAuthAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKeyServiceEndpoint
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-BlobEndpoint <String>
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
OAuthAccountServiceEndpoint
New-AzStorageContext
[[-StorageAccountName] <String>]
[-UseConnectedAccount]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
SasTokenServiceEndpoint
New-AzStorageContext
-SasToken <String>
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
ConnectionString
New-AzStorageContext
-ConnectionString <String>
[<CommonParameters>]
LocalDevelopment
New-AzStorageContext
[-Local]
[<CommonParameters>]
AnonymousAccountServiceEndpoint
New-AzStorageContext
[-Anonymous]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
Description
範例
範例 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 端點。
範例 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：使用搭配指定 Blob 端點的 OAuth 驗證來建立內容
New-AzStorageContext -UseConnectedAccount -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
此命令會使用具有指定 Blob 端點的 OAuth 驗證來建立內容。
範例 15：使用 OAuth 檔案驗證服務來建立環境定義
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
此命令會建立內容，以在檔案服務上使用 OAuth （Microsoft Entra ID） 驗證。
需要參數 '-EnableFileBackupRequestIntent' 才能針對檔案服務使用 OAuth （Microsoft Entra ID） 驗證。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。
參數
-Anonymous
指出此 Cmdlet 會建立匿名登入的 Azure 儲存體內容。
參數屬性
參數集
AnonymousAccount
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountEnvironment
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountServiceEndpoint
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BlobEndpoint
Azure 儲存體 Blob 服務端點
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccountNameAndKeyServiceEndpoint
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConnectionString
指定 Azure 儲存體內容的連接字串。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ConnectionString
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EnableFileBackupRequestIntent
與檔案的 OAuth （Microsoft Entra ID） 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。
參數屬性
參數集
OAuthAccount
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountEnvironment
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Endpoint
指定 Azure 儲存體內容的端點。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OAuthAccount
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKey
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccount
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Environment
指定 Azure 環境。
此參數可接受的值為：AzureCloud 和 AzureChinaCloud。
如需詳細資訊，請鍵入 Get-Help Get-AzEnvironment。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 名稱, EnvironmentName |
參數集
AccountNameAndKeyEnvironment
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
AnonymousAccountEnvironment
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-FileEndpoint
Azure 儲存體檔案服務端點
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccountNameAndKeyServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasTokenServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Local
指出此 Cmdlet 會使用本機開發儲存體帳戶來建立內容。
參數屬性
參數集
LocalDevelopment
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Protocol
傳輸協定 （https/http）。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 接受的值: | Http, Https |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OAuthAccount
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKey
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKeyEnvironment
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccount
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountEnvironment
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasToken
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountEnvironment
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QueueEndpoint
Azure 儲存體佇列服務端點
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccountNameAndKeyServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasTokenServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SasToken
指定內容的共用存取簽章 （SAS） 權杖。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
SasToken
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasTokenWithAzureEnvironment
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasTokenServiceEndpoint
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StorageAccountKey
指定 Azure 儲存體帳戶金鑰。
此 Cmdlet 會為此參數指定的索引鍵建立內容。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccountNameAndKey
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKeyEnvironment
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKeyServiceEndpoint
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StorageAccountName
指定 Azure 儲存體帳戶名稱。
此 Cmdlet 會為此參數指定的帳戶建立內容。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OAuthAccount
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKey
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKeyEnvironment
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccount
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountEnvironment
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasToken
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasTokenWithAzureEnvironment
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountEnvironment
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AccountNameAndKeyServiceEndpoint
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TableEndpoint
Azure 儲存體資料表服務端點
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AccountNameAndKeyServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SasTokenServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AnonymousAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseConnectedAccount
指出此 Cmdlet 會使用 OAuth （Microsoft Entra ID） 驗證來建立 Azure 儲存體內容。
當未指定其他驗證時，Cmdlet 預設會使用 OAuth 驗證。
參數屬性
參數集
OAuthAccount
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountEnvironment
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
OAuthAccountServiceEndpoint
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
