New-AzStorageContext

Referensi

Modul:: Az.Storage

Membuat konteks Azure Storage.

Sintaks

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<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>
   [<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>]
   [<CommonParameters>]

Deskripsi

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

Contoh

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

PS C:\>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

PS C:\>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

PS C:\>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

PS C:\>New-AzStorageContext -Local

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

Contoh 5: Mendapatkan kontainer untuk akun penyimpanan pengembang lokal

PS C:\>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

PS C:\>$Context01 = New-AzStorageContext -Local 
PS C:\> $Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($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

PS C:\>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

PS C:\>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

PS C:\>$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $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 dalam $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

PS C:\>Connect-AzAccount
PS C:\> $Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Perintah ini membuat konteks dengan menggunakan Autentikasi OAuth (Azure AD).

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

PS C:\> 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 dan titik akhir tabel yang ditentukan.

Contoh 12: Membuat konteks untuk accouont penyimpanan anonim dengan titik akhir file dan antrean yang ditentukan

PS C:\> New-AzStorageContext -StorageAccountName "myaccountname" -Anonymous -Protocol "http" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"

Perintah ini membuat konteks untuk penggunaan anonim untuk akun bernama myaccountname, dengan titik akhir file dan antrean yang ditentukan.

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

PS C:\>$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
PS C:\> New-AzStorageContext -StorageAccountName "myaccountname" -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 untuk akun bernama myaccountname yang menggunakan token SAS dan titik akhir blob tertentu, titik akhir tabel, titik akhir file, dan titik akhir antrean.

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

PS C:\> New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

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

Parameter

-Anonymous

Menunjukkan bahwa cmdlet ini membuat konteks Azure Storage untuk masuk anonim.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BlobEndpoint

Titik akhir layanan blob penyimpanan Azure

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionString

Menentukan string koneksi untuk konteks Azure Storage.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Endpoint

Menentukan titik akhir untuk konteks Azure Storage.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

Menentukan lingkungan Azure. Nilai yang dapat diterima untuk parameter ini adalah: AzureCloud dan AzureChinaCloud. Untuk informasi selengkapnya, ketik Get-Help Get-AzEnvironment.

Type:	String
Aliases:	Name, EnvironmentName
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-FileEndpoint

Titik akhir layanan file penyimpanan Azure

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Local

Menunjukkan bahwa cmdlet ini membuat konteks dengan menggunakan akun penyimpanan pengembangan lokal.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Protocol

Protokol Transfer (https/http).

Type:	String
Accepted values:	Http, Https
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-QueueEndpoint

Titik akhir layanan antrean penyimpanan Azure

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SasToken

Menentukan token Tanda Tangan Akses Bersama (SAS) untuk konteksnya.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountKey

Menentukan kunci akun Azure Storage. Cmdlet ini membuat konteks untuk kunci yang ditentukan parameter ini.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountName

Menentukan nama akun Azure Storage. Cmdlet ini membuat konteks untuk akun yang ditentukan parameter ini.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TableEndpoint

Titik akhir layanan tabel penyimpanan Azure

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseConnectedAccount

Menunjukkan bahwa cmdlet ini membuat konteks Azure Storage dengan Autentikasi OAuth (Azure AD). Cmdlet akan menggunakan Autentikasi OAuth secara default, ketika autentikasi lain tidak ditentukan.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Input

String

Output

AzureStorageContext