Share via

New-AzStorageShareSASToken

  • Referenz
Modul:
Az.Storage

Generieren sie das Token für freigegebene Zugriffssignaturen für die Azure Storage-Freigabe.

Syntax

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

Beschreibung

Das Cmdlet New-AzStorageShareSASToken generiert ein freigegebenes Zugriffssignaturtoken für eine Azure Storage-Freigabe.

Beispiele

Beispiel 1: Generieren eines gemeinsamen Zugriffssignaturtokens für eine Freigabe

New-AzStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

Mit diesem Befehl wird ein Token für gemeinsame Zugriffssignaturen für die Freigabe namens ContosoShare erstellt.

Beispiel 2: Generieren mehrerer freigegebener Zugriffssignaturtoken mithilfe der Pipeline

Get-AzStorageShare -Prefix "test" | New-AzStorageShareSASToken -Permission "rwdl"

Dieser Befehl ruft alle Speicherfreigaben ab, die dem Präfixtest entsprechen. Der Befehl übergibt sie mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet erstellt ein freigegebenes Zugriffstoken für jede Speicherfreigabe, die über die angegebenen Berechtigungen verfügt.

Beispiel 3: Generieren eines Gemeinsamen Zugriffssignaturtokens, das eine Richtlinie für den freigegebenen Zugriff verwendet

New-AzStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

Mit diesem Befehl wird ein Signaturtoken für den freigegebenen Zugriff für die Speicherfreigabe namens ContosoShare erstellt, die die Richtlinie "ContosoPolicy03" aufweist.

Parameter

-Context

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

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

-ExpiryTime

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

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

-Permission

Gibt die Berechtigungen im Token für den Zugriff auf die Freigabe und Dateien unter der Freigabe an. Es ist wichtig zu beachten, dass dies eine Zeichenfolge ist, z rwd . B. (für Lese-, Schreib- und Löschvorgänge).

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

-Policy

Gibt die gespeicherte Zugriffsrichtlinie für eine Freigabe 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

-ShareName

Gibt den Namen der Speicherfreigabe an.

Type:String
Aliases:N, Name
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

Eingaben

String

IStorageContext

Ausgaben

String

Hinweise

  • Schlüsselwörter: common, azure, services, data, storage, blob, queue, table