Delen via

New-AzStorageFileSASToken

  • Referentie
Module:
Az.Storage

Hiermee genereert u een Shared Access Signature-token voor een opslagbestand.

Syntaxis

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

Description

De New-AzStorageFileSASToken cmdlet genereert een shared access signature-token voor een Azure Storage-bestand.

Voorbeelden

Voorbeeld 1: Een shared Access Signature-token genereren met volledige bestandsmachtigingen

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

Met deze opdracht wordt een shared access Signature-token gegenereerd met volledige machtigingen voor het bestand met de naam FilePath.

Voorbeeld 2: Een shared Access Signature-token genereren met een tijdslimiet

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

Met de eerste opdracht maakt u een DateTime-object met behulp van de cmdlet Get-Date. Met de opdracht wordt de huidige tijd opgeslagen in de variabele $StartTime. De tweede opdracht voegt twee uur toe aan het object in $StartTime en slaat vervolgens het resultaat op in de $EndTime variabele. Dit object is een tijd twee uur in de toekomst. Met de derde opdracht wordt een shared access Signature-token gegenereerd met de opgegeven machtigingen. Dit token wordt op het huidige moment geldig. Het token blijft geldig tot de tijd die is opgeslagen in $EndTime.

Parameters

-Context

Hiermee geeft u een Azure Storage-context op. Gebruik de cmdlet New-AzStorageContext om een context te verkrijgen.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExpiryTime

Hiermee geeft u het tijdstip op waarop de handtekening voor gedeelde toegang ongeldig wordt.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FullUri

Geeft aan dat deze cmdlet de volledige blob-URI en het shared access signature-token retourneert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPAddressOrRange

Hiermee geeft u het IP-adres of bereik van IP-adressen waaruit aanvragen moeten worden geaccepteerd, zoals 168.1.5.65 of 168.1.5.60-168.1.5.70. Het bereik is inclusief.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad van het bestand ten opzichte van een opslagshare.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Permission

Hiermee geeft u de machtigingen voor een opslagbestand. Het is belangrijk om te weten dat dit een tekenreeks is, zoals rwd (voor lezen, schrijven en verwijderen).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Policy

Hiermee geeft u het opgeslagen toegangsbeleid voor een bestand.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Protocol

Hiermee geeft u het protocol dat is toegestaan voor een aanvraag. De acceptabele waarden voor deze parameter zijn:

  • HttpsOnly
  • HttpsOrHttp De standaardwaarde is HttpsOrHttp.
Type:String
Geaccepteerde waarden:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ShareFileClient

ShareFileClient-exemplaar dat het bestand vertegenwoordigt om een SAS-token op te halen.

Type:ShareFileClient
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ShareName

Hiermee geeft u de naam van de opslagshare.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StartTime

Hiermee geeft u het tijdstip op waarop de handtekening voor gedeelde toegang geldig wordt.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden