New-AzureStorageFileSASToken
Generiert ein freigegebenes Zugriffssignaturtoken für eine Speicherdatei.
Warnung
Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.
Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
New-AzureStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureStorageFileSASToken
-File <CloudFile>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureStorageFileSASToken
-File <CloudFile>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-AzureStorageFileSASToken generiert ein freigegebenes Zugriffssignaturtoken für eine Azure Storage-Datei.
Beispiele
Beispiel 1: Generieren eines Freigegebenen Zugriffssignaturtokens mit vollständigen Dateiberechtigungen
PS C:\> New-AzureStorageFileSASToken -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
PS C:\> $StartTime = Get-Date
PS C:\> $EndTime = $StartTime.AddHours(2.0)
PS C:\> New-AzureStorageFileSASToken -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-AzureStorageContext.
Typ: | IStorageContext |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
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 |
-File
Gibt ein CloudFile -Objekt an. Sie können eine Clouddatei erstellen oder eine abrufen, indem Sie das Cmdlet Get-AzureStorageFile verwenden.
Typ: | CloudFile |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
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 dies eine Zeichenfolge ist, z rwd
. B. (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. Zulässige Werte für diesen Parameter:
- HttpsOnly
- HttpsOrHttp Der Standardwert ist HttpsOrHttp.
Typ: | Nullable<T>[SharedAccessProtocol] |
Zulässige Werte: | HttpsOnly, HttpsOrHttp |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
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
Parameter: Context (ByValue)