Freigeben über

New-AzStorageFileSASToken

  • Referenz
Modul:
Az.Storage

Generiert ein freigegebenes Zugriffssignaturtoken für eine Speicherdatei.

Syntax

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

Beschreibung

Das Cmdlet New-AzStorageFileSASToken-Cmdlet generiert ein gemeinsames Zugriffssignaturtoken für eine Azure Storage-Datei.

Beispiele

Beispiel 1: Generieren eines Freigegebenen Zugriffssignaturtokens mit vollständigen Dateiberechtigungen

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

Dieser Befehl generiert ein Freigegebenes Zugriffssignaturtoken, das über vollständige Berechtigungen für die Datei verfügt, die den Namen "FilePath" hat.

Beispiel 2: Generieren eines Token für gemeinsame Zugriffssignaturen mit einem Zeitlimit

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

Der erste Befehl erstellt ein DateTime--Objekt mithilfe des Cmdlets Get-Date. Der Befehl speichert die aktuelle Uhrzeit in der variablen $StartTime. Der zweite Befehl fügt dem Objekt in $StartTime zwei Stunden hinzu und speichert dann das Ergebnis in der $EndTime Variablen. Dieses Objekt ist eine Zeit von zwei Stunden in der Zukunft. Der dritte Befehl generiert ein freigegebenes Zugriffssignaturtoken, das über die angegebenen Berechtigungen verfügt. Dieses Token wird zur aktuellen Zeit gültig. Das Token bleibt gültig, bis die in $EndTime gespeicherte Zeit liegt.

Parameter

-Context

Gibt einen Azure Storage-Kontext an. Verwenden Sie zum Abrufen eines Kontexts das cmdlet New-AzStorageContext.

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpiryTime

Gibt den Zeitpunkt an, zu dem die Signatur des freigegebenen Zugriffs ungültig wird.

Typ:Nullable<T>[DateTime]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FullUri

Gibt an, dass dieses Cmdlet den vollständigen BLOB-URI und das Signaturtoken für den freigegebenen Zugriff zurückgibt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPAddressOrRange

Gibt die IP-Adresse oder den IP-Bereich an, von denen Anforderungen akzeptiert werden sollen, z. B. 168.1.5.65 oder 168.1.5.60-168.1.5.70. Der Bereich ist inklusive.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad der Datei relativ zu einer Speicherfreigabe an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Permission

Gibt die Berechtigungen für eine Speicherdatei an. Es ist wichtig zu beachten, dass es sich hierbei um eine Zeichenfolge handelt, z. B. rwd (für Lese-, Schreib- und Löschvorgänge).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Policy

Gibt die gespeicherte Zugriffsrichtlinie für eine Datei an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Gibt das für eine Anforderung zulässige Protokoll an. Die zulässigen Werte für diesen Parameter sind:

  • HttpsOnly
  • HttpsOrHttp Der Standardwert ist HttpsOrHttp.
Typ:String
Zulässige Werte:HttpsOnly, HttpsOrHttp
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ShareFileClient

ShareFileClient-Instanz, die die Datei darstellt, mit der SAS-Token abgerufen werden soll.

Typ:ShareFileClient
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareName

Gibt den Namen der Speicherfreigabe an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StartTime

Gibt den Zeitpunkt an, zu dem die Signatur des freigegebenen Zugriffs gültig wird.

Typ:Nullable<T>[DateTime]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

ShareFileClient

IStorageContext

Ausgaben

String