New-AzStorageFileSASToken
Vygeneruje token sdíleného přístupového podpisu pro soubor úložiště.
Syntaxe
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>]
Description
Rutina New-AzStorageFileSASToken vygeneruje token sdíleného přístupového podpisu pro soubor služby Azure Storage.
Příklady
Příklad 1: Vygenerování tokenu sdíleného přístupového podpisu s úplnými oprávněními k souborům
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"
Tento příkaz vygeneruje token sdíleného přístupového podpisu, který má úplná oprávnění pro soubor s názvem FilePath.
Příklad 2: Vygenerování tokenu sdíleného přístupového podpisu s časovým limitem
$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime
První příkaz vytvoří objekt DateTime pomocí rutiny Get-Date. Příkaz uloží aktuální čas do proměnné $StartTime. Druhý příkaz přidá do objektu v $StartTime dvě hodiny a výsledek pak uloží do proměnné $EndTime. Tento objekt je v budoucnu 2 hodiny. Třetí příkaz vygeneruje token sdíleného přístupového podpisu, který má zadaná oprávnění. Tento token bude platný v aktuálním čase. Token zůstane platný až do doby uložení v $EndTime.
Parametry
-Context
Určuje kontext služby Azure Storage. K získání kontextu použijte rutinu New-AzStorageContext.
Typ: | IStorageContext |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ExpiryTime
Určuje čas, kdy se sdílený přístupový podpis stane neplatným.
Typ: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-File
Určuje objekt CloudFile . Cloudový soubor můžete vytvořit nebo ho získat pomocí rutiny Get-AzStorageFile.
Typ: | CloudFile |
Aliasy: | CloudFile |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-FullUri
Označuje, že tato rutina vrátí úplný identifikátor URI objektu blob a token sdíleného přístupového podpisu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-IPAddressOrRange
Určuje IP adresu nebo rozsah IP adres, ze kterých se mají přijímat požadavky, například 168.1.5.65 nebo 168.1.5.60-168.1.5.70. Rozsah je inkluzivní.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Path
Určuje cestu k souboru vzhledem ke sdílené složce úložiště.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Permission
Určuje oprávnění pro soubor úložiště.
Je důležité si uvědomit, že se jedná o řetězec, například rwd
(pro čtení, zápis a odstranění).
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Policy
Určuje uložené zásady přístupu pro soubor.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Protocol
Určuje protokol povolený pro požadavek. Tento parametr přijímá tyto hodnoty:
- HttpsOnly
- HttpsOrHttp Výchozí hodnota je HttpsOrHttp.
Typ: | Nullable<T>[SharedAccessProtocol] |
Přípustné hodnoty: | HttpsOnly, HttpsOrHttp |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ShareName
Určuje název sdílené složky úložiště.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-StartTime
Určuje čas, kdy se sdílený přístupový podpis stane platným.
Typ: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Související odkazy
Azure PowerShell