New-AzStorageFileSASToken
Genera un token di firma di accesso condiviso per un file di archiviazione.
Sintassi
NameSasPermission
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
NameSasPolicy
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPermission
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPolicy
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 Azure Storage.
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 Azure Storage.
Per ottenere un contesto, usare il cmdlet New-AzStorageContext.
Proprietà dei parametri
Tipo: IStorageContext
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False Alias: AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-ExpiryTime
Specifica l'ora in cui la firma di accesso condiviso non è valida.
Proprietà dei parametri
Tipo: Nullable<T> [ DateTime ]
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-FullUri
Indica che questo cmdlet restituisce l'URI BLOB completo e il token di firma di accesso condiviso.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Path
Specifica il percorso del file relativo a una condivisione di archiviazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
NameSasPermission
Posizione: 1 Obbligatorio: True Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
NameSasPolicy
Posizione: 1 Obbligatorio: True Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-Permission
Specifica le autorizzazioni per un file di archiviazione.
È importante notare che si tratta di una stringa, ad esempio (per Lettura, Scrittura ed Eliminazione).
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
NameSasPermission
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
FileSasPermission
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Policy
Specifica i criteri di accesso archiviati per un file.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
NameSasPolicy
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
FileSasPolicy
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Protocol
Specifica il protocollo consentito per una richiesta.
I valori accettabili per questo parametro sono:
HttpsOnly
HttpsOrHttp Il valore predefinito è HttpsOrHttp.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Valori accettati: HttpsOnly, HttpsOrHttp Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-ShareFileClient
Istanza di ShareFileClient per rappresentare il file in cui ottenere il token di firma di accesso condiviso.
Proprietà dei parametri
Tipo: ShareFileClient
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
FileSasPermission
Posizione: Named Obbligatorio: True Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
FileSasPolicy
Posizione: Named Obbligatorio: True Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-ShareName
Specifica il nome della condivisione di archiviazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
NameSasPermission
Posizione: 0 Obbligatorio: True Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
NameSasPolicy
Posizione: 0 Obbligatorio: True Valore dalla pipeline: True Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-StartTime
Specifica l'ora in cui la firma di accesso condiviso diventa valida.
Proprietà dei parametri
Tipo: Nullable<T> [ DateTime ]
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Output