Bagikan melalui

New-AzStorageFileSASToken

  • Referensi
Modul:
Az.Storage

Menghasilkan token tanda tangan akses bersama untuk file Storage.

Sintaks

New-AzStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageFileSASToken
   -File <CloudFile>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageFileSASToken
   -File <CloudFile>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

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

Contoh

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

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

$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -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-AzStorageContext.

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

-DefaultProfile

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

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ExpiryTime

Menentukan waktu tanda tangan akses bersama menjadi tidak valid.

Jenis:Nullable<T>[DateTime]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-File

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

Jenis:CloudFile
Alias:CloudFile
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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
Terima input alur:False
Terima karakter wildcard: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
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan jalur file relatif terhadap berbagi Penyimpanan.

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

-Policy

Menentukan kebijakan akses tersimpan untuk file.

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

-ShareName

Menentukan nama berbagi Penyimpanan.

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

-StartTime

Menentukan waktu di mana tanda tangan akses bersama menjadi valid.

Jenis:Nullable<T>[DateTime]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

CloudFile

IStorageContext

Output

String