New-AzureStorageContext
Membuat konteks Azure Storage.
Peringatan
Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.
Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.
Sintaks
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>] Deskripsi
Cmdlet New-AzureStorageContext membuat konteks Azure Storage.
Contoh
Contoh 1: Buat konteks dengan menentukan nama dan kunci akun penyimpanan
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"Perintah ini membuat konteks untuk akun bernama ContosoGeneral yang menggunakan kunci yang ditentukan.
Contoh 2: Membuat konteks dengan menentukan string koneksi
C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"Perintah ini membuat konteks berdasarkan string koneksi yang ditentukan untuk akun ContosoGeneral.
Contoh 3: Membuat konteks untuk akun penyimpanan anonim
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"Perintah ini membuat konteks untuk penggunaan anonim untuk akun bernama ContosoGeneral. Perintah menentukan HTTP sebagai protokol koneksi.
Contoh 4: Membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal
C:\PS>New-AzureStorageContext -LocalPerintah ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal. Perintah menentukan parameter Lokal .
Contoh 5: Dapatkan kontainer untuk akun penyimpanan pengembang lokal
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainerPerintah ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal, lalu meneruskan konteks baru ke cmdlet Get-AzureStorageContainer dengan menggunakan operator alur. Perintah mendapatkan kontainer Azure Storage untuk akun penyimpanan pengembang lokal.
Contoh 6: Mendapatkan beberapa kontainer
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-AzureStorageContainerPerintah pertama membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal, lalu menyimpan konteks tersebut dalam variabel $Context 01. Perintah kedua membuat konteks untuk akun bernama ContosoGeneral yang menggunakan kunci yang ditentukan, lalu menyimpan konteks tersebut dalam variabel $Context 02. Perintah akhir mendapatkan kontainer untuk konteks yang disimpan di $Context 01 dan $Context 02 dengan menggunakan Get-AzureStorageContainer.
Contoh 7: Membuat konteks dengan titik akhir
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"Perintah ini membuat konteks Azure Storage yang memiliki titik akhir penyimpanan yang ditentukan. Perintah membuat konteks untuk akun bernama ContosoGeneral yang menggunakan kunci yang ditentukan.
Contoh 8: Membuat konteks dengan lingkungan tertentu
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"Perintah ini membuat konteks penyimpanan Azure yang memiliki lingkungan Azure yang ditentukan. Perintah membuat konteks untuk akun bernama ContosoGeneral yang menggunakan kunci yang ditentukan.
Contoh 9: Membuat konteks dengan menggunakan token 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"Perintah pertama menghasilkan token SAS dengan menggunakan cmdlet New-AzureStorageContainerSASToken untuk kontainer bernama ContosoMain, lalu menyimpan token tersebut dalam variabel $SasToken. Token tersebut untuk izin baca, tambahkan, perbarui, dan hapus. Perintah kedua membuat konteks untuk akun bernama ContosoGeneral yang menggunakan token SAS yang disimpan di $SasToken, lalu menyimpan konteks tersebut dalam variabel $Context. Perintah akhir mencantumkan semua blob yang terkait dengan kontainer bernama ContosoMain dengan menggunakan konteks yang disimpan dalam $Context.
Contoh 10: Membuat konteks dengan menggunakan Autentikasi OAuth
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountPerintah ini membuat konteks dengan menggunakan Autentikasi OAuth.
Parameter
-Anonymous
Menunjukkan bahwa cmdlet ini membuat konteks Azure Storage untuk masuk anonim.
| Jenis: | SwitchParameter |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-ConnectionString
Menentukan string koneksi untuk konteks Azure Storage.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Endpoint
Menentukan titik akhir untuk konteks Azure Storage.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Environment
Menentukan lingkungan Azure.
Nilai yang dapat diterima untuk parameter ini adalah: AzureCloud dan AzureChinaCloud.
Untuk informasi selengkapnya, ketik Get-Help Get-AzureEnvironment.
| Jenis: | String |
| Alias: | Name, EnvironmentName |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-Local
Menunjukkan bahwa cmdlet ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal.
| Jenis: | SwitchParameter |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Protocol
Protokol Transfer (https/http).
| Jenis: | String |
| Nilai yang diterima: | Http, Https |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-SasToken
Menentukan token Tanda Tangan Akses Bersama (SAS) untuk konteks tersebut.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-StorageAccountKey
Menentukan kunci akun Azure Storage. Cmdlet ini membuat konteks untuk kunci yang ditentukan parameter ini.
| Jenis: | String |
| Position: | 1 |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-StorageAccountName
Menentukan nama akun Azure Storage. Cmdlet ini membuat konteks untuk akun yang ditentukan parameter ini.
| Jenis: | String |
| Position: | 0 |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-UseConnectedAccount
Menunjukkan bahwa cmdlet ini membuat konteks Azure Storage dengan Autentikasi OAuth. Cmdlet akan menggunakan OAuth Authentication secara default, ketika autentikasi lain tidak ditentukan.
| Jenis: | SwitchParameter |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |