New-AzStorageContext
Membuat konteks Azure Storage.
Sintaks
OAuthAccount (Default)
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>]
Deskripsi
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 akhir 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.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
AnonymousAccount
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountEnvironment
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountServiceEndpoint
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-BlobEndpoint
Azure titik akhir layanan blob penyimpanan
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
AccountNameAndKeyServiceEndpoint
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-ConnectionString
Menentukan string koneksi untuk konteks Azure Storage.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
ConnectionString
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
OAuthAccount
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountEnvironment
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Endpoint
Menentukan titik akhir untuk konteks Azure Storage.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
OAuthAccount
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKey
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccount
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasToken
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Environment
Menentukan lingkungan Azure.
Nilai yang dapat diterima untuk parameter ini adalah: AzureCloud dan AzureChinaCloud.
Untuk informasi selengkapnya, ketik Get-Help Get-AzEnvironment.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: Name, Nama Lingkungan
Kumpulan parameter
AccountNameAndKeyEnvironment
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
AnonymousAccountEnvironment
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-FileEndpoint
Azure titik akhir layanan file penyimpanan
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
AccountNameAndKeyServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasTokenServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Local
Menunjukkan bahwa cmdlet ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
LocalDevelopment
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Protocol
Protokol Transfer (https/http).
Properti parameter
Jenis: String
Nilai default: None
Nilai yang diterima: Http, Https
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
OAuthAccount
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKey
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKeyEnvironment
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccount
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountEnvironment
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasToken
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountEnvironment
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-QueueEndpoint
Azure titik akhir layanan antrean penyimpanan
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
AccountNameAndKeyServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasTokenServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-SasToken
Menentukan token Tanda Tangan Akses Bersama (SAS) untuk konteks tersebut.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
SasToken
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasTokenWithAzureEnvironment
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasTokenServiceEndpoint
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-StorageAccountKey
Menentukan kunci akun Azure Storage.
Cmdlet ini membuat konteks untuk kunci yang ditentukan parameter ini.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
AccountNameAndKey
Position: 1
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKeyEnvironment
Position: 1
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKeyServiceEndpoint
Position: 1
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-StorageAccountName
Menentukan nama akun Azure Storage.
Cmdlet ini membuat konteks untuk akun yang ditentukan parameter ini.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
OAuthAccount
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKey
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKeyEnvironment
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccount
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountEnvironment
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasToken
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasTokenWithAzureEnvironment
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountEnvironment
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AccountNameAndKeyServiceEndpoint
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-TableEndpoint
Azure titik akhir layanan tabel penyimpanan
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
AccountNameAndKeyServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
SasTokenServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
AnonymousAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
OAuthAccount
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountEnvironment
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
OAuthAccountServiceEndpoint
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters .
Output