Freigeben über

New-AzureStorageContainerSASToken

  • Referenz
Modul:
Azure.Storage

Generiert ein SAS-Token für einen Azure-Speichercontainer.

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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

New-AzureStorageContainerSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageContainerSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureStorageContainerSASToken generiert ein SAS-Token (Shared Access Signature) für einen Azure-Speichercontainer.

Beispiele

Beispiel 1: Generieren eines SAS-Containers mit vollständiger Containerberechtigung

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Permission rwdl

In diesem Beispiel wird ein Container-SAS-Token mit vollständiger Containerberechtigung generiert.

Beispiel 2: Generieren mehrerer Container-SAS-Token per Pipeline

PS C:\>Get-AzureStorageContainer -Container test* | New-AzureStorageContainerSASToken -Permission rwdl

In diesem Beispiel werden mehrere Container-SAS-Token mithilfe der Pipeline generiert.

Beispiel 3: Generieren eines SAS-Containertokens mit freigegebener Zugriffsrichtlinie

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Policy "PolicyName"

In diesem Beispiel wird ein Container-SAS-Token mit freigegebener Zugriffsrichtlinie generiert.

Parameter

-Context

Gibt einen Azure-Speicherkontext an. Sie können es mithilfe des Cmdlets New-AzureStorageContext erstellen.

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. Wenn der Benutzer die Startzeit, aber nicht die Ablaufzeit festlegt, wird die Ablaufzeit auf die Startzeit plus eine Stunde festgelegt. Wenn weder die Startzeit noch die Ablaufzeit angegeben ist, wird die Ablaufzeit auf die aktuelle Uhrzeit plus eine Stunde festgelegt.

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

-Name

Gibt einen Azure-Speichercontainernamen an.

Typ:String
Aliase:N, Container
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Permission

Gibt Berechtigungen für einen Speichercontainer 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 eine Azure Stored Access-Richtlinie 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

-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

IStorageContext

Ausgaben

String