Bagikan melalui


New-AzStorageContext

Membuat konteks Azure Storage.

Sintaks

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>]

Deskripsi

Cmdlet New-AzStorageContext membuat konteks Azure Storage. Autentikasi default Konteks Penyimpanan adalah OAuth (ID Microsoft Entra), jika hanya memasukkan nama akun Penyimpanan. Lihat detail autentikasi Layanan Penyimpanan di https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Contoh

Contoh 1: Buat konteks dengan menentukan nama dan kunci akun penyimpanan

New-AzStorageContext -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

New-AzStorageContext -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

New-AzStorageContext -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

New-AzStorageContext -Local

Perintah ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal. Perintah menentukan parameter Lokal .

Contoh 5: Dapatkan kontainer untuk akun penyimpanan pengembang lokal

New-AzStorageContext -Local | Get-AzStorageContainer

Perintah ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal, lalu meneruskan konteks baru ke cmdlet Get-AzStorageContainer dengan menggunakan operator alur. Perintah mendapatkan kontainer Azure Storage untuk akun penyimpanan pengembang lokal.

Contoh 6: Mendapatkan beberapa kontainer

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

Perintah 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-AzStorageContainer.

Contoh 7: Membuat konteks dengan titik akhir

New-AzStorageContext -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

New-AzStorageContext -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

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

Perintah pertama menghasilkan token SAS dengan menggunakan cmdlet New-AzStorageContainerSASToken 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

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Perintah ini membuat konteks dengan menggunakan Autentikasi OAuth (MICROSOFT Entra ID).

Contoh 11: Buat konteks dengan menentukan nama akun penyimpanan, kunci akun penyimpanan, dan titik akhir blob kustom

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Perintah ini membuat konteks untuk akun bernama myaccountname dengan kunci untuk akun, dan titik akhir blob yang ditentukan.

Contoh 12: Membuat konteks untuk akun penyimpanan anonim dengan titik akhir blob yang ditentukan

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Perintah ini membuat konteks untuk penggunaan anonim untuk akun bernama myaccountname, dengan titik enpoint blob yang ditentukan.

Contoh 13: Membuat konteks dengan menggunakan token SAS dengan titik akhir yang ditentukan

$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/"

Perintah pertama menghasilkan token SAS dengan menggunakan cmdlet New-AzStorageContainerSASToken untuk kontainer bernama MyContainer, lalu menyimpan token tersebut dalam variabel $SasToken. Perintah kedua membuat konteks yang menggunakan token SAS dan titik akhir blob tertentu, titik akhir tabel, titik akhir file, dan titik akhir antrean.

Contoh 14: Membuat konteks dengan menggunakan Autentikasi OAuth dengan titik akhir blob tertentu

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

Perintah ini membuat konteks dengan menggunakan autentikasi OAuth dengan titik akhir blob tertentu.

Contoh 15: Membuat konteks dengan menggunakan Autentikasi OAuth pada layanan File

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Perintah ini membuat konteks untuk menggunakan autentikasi OAuth (MICROSOFT Entra ID) pada layanan File. Parameter '-EnableFileBackupRequestIntent' diperlukan untuk menggunakan Autentikasi OAuth (Microsoft Entra ID) untuk layanan File. Ini akan melewati pemeriksaan izin tingkat file/direktori apa pun dan mengizinkan akses, berdasarkan tindakan data yang diizinkan, bahkan jika ada ACL yang berlaku untuk file/direktori tersebut.

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

-BlobEndpoint

Titik akhir layanan blob penyimpanan Azure

Jenis:String
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

-EnableFileBackupRequestIntent

Parameter yang diperlukan untuk digunakan dengan Autentikasi OAuth (MICROSOFT Entra ID) untuk File. Ini akan melewati pemeriksaan izin tingkat file/direktori apa pun dan mengizinkan akses, berdasarkan tindakan data yang diizinkan, bahkan jika ada ACL yang berlaku untuk file/direktori tersebut.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
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-AzEnvironment.

Jenis:String
Alias:Name, EnvironmentName
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-FileEndpoint

Titik akhir layanan file penyimpanan Azure

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
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

-QueueEndpoint

Titik akhir layanan antrean penyimpanan Azure

Jenis:String
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

-TableEndpoint

Titik akhir layanan tabel penyimpanan Azure

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-UseConnectedAccount

Menunjukkan bahwa cmdlet ini membuat konteks Azure Storage dengan Autentikasi OAuth (MICROSOFT Entra ID). 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

Input

String

Output

AzureStorageContext