Dela via

New-AzStorageFileSASToken

  • Referens
Modul:
Az.Storage

Genererar en signaturtoken för delad åtkomst för en lagringsfil.

Syntax

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>]

Description

Cmdleten New-AzStorageFileSASToken genererar en signaturtoken för delad åtkomst för en Azure Storage-fil.

Exempel

Exempel 1: Generera en signaturtoken för delad åtkomst som har fullständiga filbehörigheter

New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

Det här kommandot genererar en signaturtoken för delad åtkomst som har fullständiga behörigheter för filen med namnet FilePath.

Exempel 2: Generera en signaturtoken för delad åtkomst som har en tidsgräns

$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

Det första kommandot skapar ett DateTime-objekt med cmdleten Get-Date. Kommandot lagrar den aktuella tiden i variabeln $StartTime. Det andra kommandot lägger till två timmar till objektet i $StartTime och lagrar sedan resultatet i variabeln $EndTime. Det här objektet är en tid två timmar i framtiden. Det tredje kommandot genererar en signaturtoken för delad åtkomst som har de angivna behörigheterna. Den här token blir giltig vid den aktuella tidpunkten. Token förblir giltig tills tiden lagras i $EndTime.

Parametrar

-Context

Anger en Azure Storage-kontext. Om du vill hämta en kontext använder du cmdleten New-AzStorageContext.

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExpiryTime

Anger den tidpunkt då signaturen för delad åtkomst blir ogiltig.

Typ:Nullable<T>[DateTime]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-File

Anger ett CloudFile-objekt . Du kan skapa en molnfil eller hämta en med hjälp av cmdleten Get-AzStorageFile.

Typ:CloudFile
Alias:CloudFile
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-FullUri

Anger att den här cmdleten returnerar den fullständiga blob-URI:n och signaturtoken för delad åtkomst.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IPAddressOrRange

Anger IP-adressen eller ip-adressintervallet som begäranden ska accepteras från, till exempel 168.1.5.65 eller 168.1.5.60-168.1.5.70. Intervallet är inkluderande.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till filen i förhållande till en lagringsresurs.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Permission

Anger behörigheterna för en lagringsfil. Det är viktigt att observera att det här är en sträng, till exempel rwd (för Läs, Skriv och Ta bort).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Policy

Anger den lagrade åtkomstprincipen för en fil.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Anger vilket protokoll som tillåts för en begäran. De acceptabla värdena för den här parametern är:

  • HttpsOnly
  • HttpsOrHttp Standardvärdet är HttpsOrHttp.
Typ:Nullable<T>[SharedAccessProtocol]
Godkända värden:HttpsOnly, HttpsOrHttp
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ShareName

Anger namnet på lagringsresursen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StartTime

Anger den tidpunkt då signaturen för delad åtkomst blir giltig.

Typ:Nullable<T>[DateTime]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

CloudFile

IStorageContext

Utdata

String