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.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpiryTime

Menentukan waktu tanda tangan akses bersama menjadi tidak valid.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

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

Type:CloudFile
Aliases:CloudFile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-FullUri

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

Type:SwitchParameter
Position:Named
Default value:None
Required: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.

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

-Path

Menentukan jalur file relatif terhadap berbagi Penyimpanan.

Type:String
Position:1
Default value:None
Required: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).

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

-Policy

Menentukan kebijakan akses tersimpan untuk file.

Type:String
Position:Named
Default value:None
Required: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.
Type:Nullable<T>[SharedAccessProtocol]
Accepted values:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareName

Menentukan nama berbagi Penyimpanan.

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

-StartTime

Menentukan waktu di mana tanda tangan akses bersama menjadi valid.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

CloudFile

IStorageContext

Output

String