New-AzureStorageShareSASToken

  • Referens
Modul:
Azure.Storage

Generera signaturtoken för delad åtkomst för Azure Storage-resurs.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten New-AzureStorageShareSASToken genererar en signaturtoken för delad åtkomst för en Azure Storage-resurs.

Exempel

Exempel 1: Generera en signaturtoken för delad åtkomst för en resurs

PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

Det här kommandot skapar en signaturtoken för delad åtkomst för resursen med namnet ContosoShare.

Exempel 2: Generera flera signaturtoken för delad åtkomst med hjälp av pipelinen

PS C:\>Get-AzureStorageShare -Prefix "test" | New-AzureStorageShareSASToken -Permission "rwdl"

Det här kommandot hämtar alla lagringsresurser som matchar prefixtestet. Kommandot skickar dem till den aktuella cmdleten med hjälp av pipelineoperatorn. Den aktuella cmdleten skapar en token för delad åtkomst för varje lagringsresurs som har de angivna behörigheterna.

Exempel 3: Generera en signaturtoken för delad åtkomst som använder en princip för delad åtkomst

PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

Det här kommandot skapar en signaturtoken för delad åtkomst för lagringsresursen ContosoShare som har principen ContosoPolicy03.

Parametrar

-Context

Anger en Azure Storage-kontext. Om du vill hämta en kontext använder du cmdleten New-AzureStorageContext.

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExpiryTime

Anger den tidpunkt då signaturen för delad åtkomst blir ogiltig.

Typ:Nullable<T>[DateTime]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FullUri

Anger att den här cmdleten returnerar den fullständiga blob-URI:n och signaturtoken för delad åtkomst.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IPAddressOrRange

Anger IP-adressen eller ip-adressintervallet som begäranden ska accepteras från, till exempel 168.1.5.65 eller 168.1.5.60-168.1.5.70. Intervallet är inkluderande.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Permission

Anger behörigheterna i token för åtkomst till resursen och filerna under resursen. Det är viktigt att observera att det här är en sträng, till exempel rwd (för Läs, Skriv och Ta bort).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Policy

Anger den lagrade åtkomstprincipen för en resurs.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Anger vilket protokoll som tillåts för en begäran. De acceptabla värdena för den här parametern är:

  • HttpsOnly
  • HttpsOrHttp Standardvärdet är HttpsOrHttp.
Typ:Nullable<T>[SharedAccessProtocol]
Godkända värden:HttpsOnly, HttpsOrHttp
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ShareName

Anger namnet på lagringsresursen.

Typ:String
Alias:N, Name
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StartTime

Anger den tidpunkt då signaturen för delad åtkomst blir giltig.

Typ:Nullable<T>[DateTime]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

IStorageContext

Utdata

String

Kommentarer

  • Nyckelord: common, azure, services, data, storage, blob, queue, table