Dela via


New-AzStorageContainerSASToken

Genererar en SAS-token för en Azure Storage-container.

Syntax

SasPolicy

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

SasPermission

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

Description

Cmdleten New-AzStorageContainerSASToken genererar en SAS-token (Signatur för delad åtkomst) för en Azure-lagringscontainer.

Exempel

Exempel 1: Generera en CONTAINER SAS-token med fullständig containerbehörighet

New-AzStorageContainerSASToken -Name "Test" -Permission rwdl

Det här exemplet genererar en CONTAINER SAS-token med fullständig containerbehörighet.

Exempel 2: Generera flera SAS-containertoken per pipeline

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

Det här exemplet genererar flera SAS-containertoken med hjälp av pipelinen.

Exempel 3: Generera container-SAS-token med principen för delad åtkomst

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

Det här exemplet genererar en CONTAINER SAS-token med principen för delad åtkomst.

Exempel 3: Generera en SAS-token för användaridentitetscontainer med lagringskontext baserat på OAuth-autentisering

$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

Det här exemplet genererar en SAS-token för användaridentitetscontainer med lagringskontext baserat på OAuth-autentisering

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Context

Anger en Azure Storage-kontext. Du kan skapa den med hjälp av cmdleten New-AzStorageContext. När lagringskontexten baseras på OAuth-autentisering genererar en SAS-token för användaridentitetscontainer.

Parameteregenskaper

Typ:IStorageContext
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EncryptionScope

Krypteringsomfång som ska användas när begäranden som auktoriseras med denna SAS-URI skickas.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ExpiryTime

Anger den tidpunkt då signaturen för delad åtkomst blir ogiltig. Om användaren anger starttiden men inte förfallotiden anges förfallotiden till starttiden plus en timme. Om varken starttiden eller förfallotiden har angetts anges förfallotiden till aktuell tid plus en timme. När lagringskontexten baseras på OAuth-autentisering måste förfallotiden vara 7 dagar från aktuell tid och får inte vara tidigare än aktuell tid.

Parameteregenskaper

Typ:

Nullable<T>[DateTime]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FullUri

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Anger ett Azure Storage-containernamn.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:N, Container

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Permission

Anger behörigheter för en lagringscontainer. Det är viktigt att observera att det här är en sträng, till exempel rwd (för Läs, Skriv och Ta bort). De behörigheter som stöds för containerresurstypen beskrivs här.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SasPermission
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Policy

Anger en azure-princip för lagrad åtkomst.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SasPolicy
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp Standardvärdet är HttpsOrHttp.

Parameteregenskaper

Typ:

Nullable<T>[Microsoft.Azure.Storage.SharedAccessProtocol]

Standardvärde:None
Godkända värden:HttpsOnly, HttpsOrHttp
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-StartTime

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

Parameteregenskaper

Typ:

Nullable<T>[DateTime]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

IStorageContext

Utdata

String