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 <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageFileSASToken
   -File <CloudFile>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageFileSASToken
   -File <CloudFile>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-Az Archiviazione FileSASToken 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-Az Archiviazione Context.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-ExpiryTime

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

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

-File

Specifica un oggetto CloudFile . È possibile creare un file cloud o ottenerlo usando il cmdlet Get-Az Archiviazione File.

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

-FullUri

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

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

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

-Path

Specifica il percorso del file relativo a una condivisione Archiviazione.

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

-Permission

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

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

-Policy

Specifica i criteri di accesso archiviati per un file.

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

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp Il valore predefinito è 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

Specifica il nome della condivisione Archiviazione.

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

-StartTime

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

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

Input

String

CloudFile

IStorageContext

Output

String