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-Azure 儲存體 Context 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-Azure 儲存體 Container 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-Azure 儲存體 Container 取得儲存在 $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-Azure 儲存體 ContainerSASToken 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

輸入

String

輸出

AzureStorageContext