New-AzureStorageContext
建立 Azure 儲存體 內容。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>]
New-AzureStorageContext
-ConnectionString <String>
[<CommonParameters>]
New-AzureStorageContext
[-Local]
[<CommonParameters>]
Description
New-AzureStorageContext Cmdlet 會建立 Azure 儲存體 內容。
範例
範例 1:藉由指定記憶體帳戶名稱和金鑰來建立內容
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
此命令會針對使用指定索引鍵的帳戶建立名為 ContosoGeneral 的內容。
範例 2:藉由指定 連接字串 來建立內容
C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"
此命令會根據 ContosoGeneral 帳戶的指定 連接字串 建立內容。
範例 3:建立匿名記憶體帳戶的內容
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"
此命令會為名為 ContosoGeneral 的帳戶建立匿名使用的內容。 命令會將 HTTP 指定為連線通訊協定。
範例 4:使用本機開發記憶體帳戶建立內容
C:\PS>New-AzureStorageContext -Local
此命令會使用本機開發記憶體帳戶來建立內容。 命令會 指定 Local 參數。
範例 5:取得本機開發人員記憶體帳戶的容器
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainer
此命令會使用本機開發記憶體帳戶建立內容,然後使用管線運算符將新內容傳遞至 Get-AzureStorageContainer Cmdlet。 命令會取得本機開發人員記憶體帳戶的 Azure 儲存體 容器。
範例 6:取得多個容器
C:\PS>$Context01 = New-AzureStorageContext -Local
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer
第一個命令會使用本機開發記憶體帳戶來建立內容,然後將該內容儲存在 $Context 01 變數中。 第二個命令會建立名為 ContosoGeneral 的帳戶內容,該帳戶會使用指定的索引鍵,然後將該內容儲存在 $Context 02 變數中。 最後一個命令會使用 Get-AzureStorageContainer 取得儲存在 $Context 01 和 $Context 02 的內容容器。
範例 7:使用端點建立內容
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"
此命令會建立具有指定記憶體端點的 Azure 儲存體 內容。 命令會建立名為 ContosoGeneral 之帳戶的內容,該帳戶會使用指定的索引鍵。
範例 8:使用指定的環境建立內容
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"
此命令會建立具有指定 Azure 環境的 Azure 記憶體內容。 命令會建立名為 ContosoGeneral 之帳戶的內容,該帳戶會使用指定的索引鍵。
範例 9:使用 SAS 令牌建立內容
C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"
第一個命令會針對名為 ContosoMain 的容器使用 New-AzureStorageContainerSASToken Cmdlet 來產生 SAS 令牌,然後將該令牌儲存在 $SasToken 變數中。 該令牌適用於讀取、新增、更新和刪除許可權。 第二個命令會針對名為 ContosoGeneral 的帳戶建立內容,該帳戶會使用儲存在 $SasToken 中的 SAS 令牌,然後將該內容儲存在 $Context 變數中。 最後一個命令會使用儲存在 $Context 中的內容,列出與名為 ContosoMain 之容器相關聯的所有 Blob。
範例 10:使用 OAuth 驗證建立內容
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount
此命令會使用 OAuth 驗證來建立內容。
參數
-Anonymous
指出此 Cmdlet 會為匿名登入建立 Azure 儲存體 內容。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ConnectionString
指定 Azure 儲存體 內容的 連接字串。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Endpoint
指定 Azure 儲存體 內容的端點。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Environment
指定 Azure 環境。
此參數可接受的值為:AzureCloud 和 AzureChinaCloud。
如需詳細資訊,請輸入 Get-Help Get-AzureEnvironment
。
類型: | String |
別名: | Name, EnvironmentName |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Local
表示此 Cmdlet 會使用本機開發記憶體帳戶來建立內容。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Protocol
傳輸通訊協議(HTTPs/HTTP)。
類型: | String |
接受的值: | Http, Https |
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 |
-UseConnectedAccount
指出此 Cmdlet 會使用 OAuth 驗證建立 Azure 儲存體 內容。 如果未指定其他驗證,Cmdlet 預設會使用 OAuth 驗證。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |