Bagikan melalui


New-AzureStorageFileSASToken

Menghasilkan token tanda tangan akses bersama untuk file 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-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   -File <CloudFile>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   -File <CloudFile>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureStorageFileSASToken menghasilkan token tanda tangan akses bersama untuk file Azure Storage.

Contoh

Contoh 1: Membuat token tanda tangan akses bersama yang memiliki izin file lengkap

PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

Perintah ini menghasilkan token tanda tangan akses bersama yang memiliki izin penuh untuk file yang bernama FilePath.

Contoh 2: Membuat token tanda tangan akses bersama yang memiliki batas waktu

PS C:\> $StartTime = Get-Date
PS C:\> $EndTime = $StartTime.AddHours(2.0)
PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

Perintah pertama membuat objek DateTime dengan menggunakan cmdlet Get-Date. Perintah menyimpan waktu saat ini dalam variabel $StartTime. Perintah kedua menambahkan dua jam ke objek di $StartTime, lalu menyimpan hasilnya dalam variabel $EndTime. Objek ini adalah waktu dua jam di masa mendatang. Perintah ketiga menghasilkan token tanda tangan akses bersama yang memiliki izin yang ditentukan. Token ini menjadi valid pada saat ini. Token tetap valid hingga waktu disimpan dalam $EndTime.

Parameter

-Context

Menentukan konteks Azure Storage. Untuk mendapatkan konteks, gunakan cmdlet New-AzureStorageContext.

Jenis:IStorageContext
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpiryTime

Menentukan waktu tanda tangan akses bersama menjadi tidak valid.

Jenis:Nullable<T>[DateTime]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Menentukan objek CloudFile. Anda dapat membuat file cloud atau mendapatkannya dengan menggunakan cmdlet Get-AzureStorageFile.

Jenis:CloudFile
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-FullUri

Menunjukkan bahwa cmdlet ini mengembalikan URI blob lengkap dan token tanda tangan akses bersama.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddressOrRange

Menentukan alamat IP atau rentang alamat IP tempat menerima permintaan, seperti 168.1.5.65 atau 168.1.5.60-168.1.5.70. Rentangnya inklusif.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Menentukan jalur file relatif terhadap berbagi Penyimpanan.

Jenis:String
Position:1
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-Permission

Menentukan izin untuk file Penyimpanan. Penting untuk dicatat bahwa ini adalah string, seperti rwd (untuk Baca, Tulis, dan Hapus).

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

Menentukan kebijakan akses tersimpan untuk file.

Jenis:String
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Menentukan protokol yang diizinkan untuk permintaan. Nilai yang dapat diterima untuk parameter ini adalah:

  • HttpsOnly
  • HttpsOrHttp Nilai defaultnya adalah HttpsOrHttp.
Jenis:Nullable<T>[SharedAccessProtocol]
nilai yang diterima:HttpsOnly, HttpsOrHttp
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareName

Menentukan nama berbagi Penyimpanan.

Jenis:String
Position:0
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-StartTime

Menentukan waktu di mana tanda tangan akses bersama menjadi valid.

Jenis:Nullable<T>[DateTime]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

CloudFile

IStorageContext

Parameter: Konteks (ByValue)

Output

String