Freigeben über

New-AzStorageContainerSASToken

  • Referenz
Modul:
Az.Storage

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

Syntax

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

Beschreibung

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

Beispiele

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

New-AzStorageContainerSASToken -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

Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -Permission rwdl

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

Beispiel 3: Generieren eines SAS-Containertokens mit freigegebener Zugriffsrichtlinie

New-AzStorageContainerSASToken -Name "Test" -Policy "PolicyName"

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

Beispiel 3: Generieren eines SAS-Tokens für Benutzeridentitätscontainer mit Speicherkontext basierend auf der OAuth-Authentifizierung

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageContainerSASToken -Name "ContainerName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -context $ctx

In diesem Beispiel wird ein SAS-Token für Benutzeridentitätscontainer mit Speicherkontext basierend auf der OAuth-Authentifizierung generiert.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Gibt einen Azure-Speicherkontext an. Sie können es mithilfe des Cmdlets New-AzStorageContext erstellen. Wenn der Speicherkontext auf der OAuth-Authentifizierung basiert, wird ein SAS-Token für den Benutzeridentitätscontainer generiert.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionScope

Verschlüsselungsbereich, der beim Senden von Anforderungen verwendet werden soll, die mit diesem SAS-URI autorisiert sind.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Wenn der Speicherkontext auf der OAuth-Authentifizierung basiert, muss die Ablaufzeit 7 Tage ab der aktuellen Zeit betragen und darf nicht früher als die aktuelle Uhrzeit sein.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullUri

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt einen Azure-Speichercontainernamen an.

Type:String
Aliases:N, Container
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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). Die Berechtigungen, die für den Containerressourcentyp unterstützt werden, werden hier beschrieben.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

Gibt eine Azure Stored Access-Richtlinie an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.
Type:Nullable<T>[SharedAccessProtocol]
Accepted values:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

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

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

IStorageContext

Ausgaben

String