Condividi tramite

New-AzStorageFileSASToken

  • Riferimento
Modulo:
Az.Storage

Genera un token di firma di accesso condiviso per un file di archiviazione.

Sintassi

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

Descrizione

Il cmdlet New-AzStorageFileSASToken genera un token di firma di accesso condiviso per un file di archiviazione di Azure.

Esempio

Esempio 1: Generare un token di firma di accesso condiviso con autorizzazioni di file complete

New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

Questo comando genera un token di firma di accesso condiviso con autorizzazioni complete per il file denominato FilePath.

Esempio 2: Generare un token di firma di accesso condiviso con un limite di tempo

$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

Il primo comando crea un oggetto DateTime usando il cmdlet Get-Date. Il comando archivia l'ora corrente nella variabile $StartTime. Il secondo comando aggiunge due ore all'oggetto in $StartTime e quindi archivia il risultato nella variabile $EndTime. Questo oggetto è una volta due ore in futuro. Il terzo comando genera un token di firma di accesso condiviso con le autorizzazioni specificate. Questo token diventa valido al momento corrente. Il token rimane valido fino a quando non viene archiviato in $EndTime.

Parametri

-Context

Specifica un contesto di Archiviazione di Azure. Per ottenere un contesto, usare il cmdlet New-AzStorageContext.

Tipo:IStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExpiryTime

Specifica l'ora in cui la firma di accesso condiviso non è valida.

Tipo:Nullable<T>[DateTime]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FullUri

Indica che questo cmdlet restituisce l'URI BLOB completo e il token di firma di accesso condiviso.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IPAddressOrRange

Specifica l'indirizzo IP o l'intervallo di indirizzi IP da cui accettare richieste, ad esempio 168.1.5.65 o 168.1.5.60-168.1.5.70. L'intervallo è inclusivo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso del file relativo a una condivisione di archiviazione.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Permission

Specifica le autorizzazioni per un file di archiviazione. È importante notare che si tratta di una stringa, ad esempio rwd (per Lettura, Scrittura ed Eliminazione).

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Policy

Specifica i criteri di accesso archiviati per un file.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Specifica il protocollo consentito per una richiesta. I valori accettabili per questo parametro sono:

  • HttpsOnly
  • HttpsOrHttp Il valore predefinito è HttpsOrHttp.
Tipo:String
Valori accettati:HttpsOnly, HttpsOrHttp
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ShareFileClient

Istanza di ShareFileClient per rappresentare il file in cui ottenere il token di firma di accesso condiviso.

Tipo:ShareFileClient
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ShareName

Specifica il nome della condivisione di archiviazione.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StartTime

Specifica l'ora in cui la firma di accesso condiviso diventa valida.

Tipo:Nullable<T>[DateTime]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

ShareFileClient

IStorageContext

Output

String