New-AzStorageFileSASToken
Vygeneruje token sdíleného přístupového podpisu pro soubor úložiště.
Syntax
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>]
Description
Rutina New-AzStorageFileSASToken vygeneruje token sdíleného přístupového podpisu pro soubor 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 Azure Storage.
K získání kontextu použijte rutinu New-AzStorageContext .
Vlastnosti parametru
Typ: IStorageContext
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Vlastnosti parametru
Typ: IAzureContextContainer
Default value: None Podporuje zástupné znaky: False DontShow: False Aliasy: AzureRmContext, AzureCredential
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-ExpiryTime
Určuje čas, kdy se sdílený přístupový podpis stane neplatným.
Vlastnosti parametru
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-FullUri
Označuje, že tato rutina vrátí úplný identifikátor URI objektu blob a token sdíleného přístupového podpisu.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: 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í.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-Path
Určuje cestu k souboru vzhledem ke sdílené složce úložiště.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
NameSasPermission
Position: 1 Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
NameSasPolicy
Position: 1 Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: 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í).
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
NameSasPermission
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
FileSasPermission
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-Policy
Určuje uložené zásady přístupu pro soubor.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
NameSasPolicy
Position: Named Povinné: True Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
FileSasPolicy
Position: Named Povinné: True Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-Protocol
Určuje protokol povolený pro požadavek.
Přijatelné hodnoty pro tento parametr jsou:
HttpsOnly
HttpsOrHttp Výchozí hodnota je HttpsOrHttp.
Vlastnosti parametru
Typ: String
Default value: None Přípustné hodnoty: HttpsOnly, HttpsOrHttp Podporuje zástupné znaky: False DontShow: False
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
-ShareFileClient
Instance ShareFileClient, která představuje soubor pro získání tokenu SAS.
Vlastnosti parametru
Typ: ShareFileClient
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
FileSasPermission
Position: Named Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
FileSasPolicy
Position: Named Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-ShareName
Určuje název sdílené složky úložiště.
Vlastnosti parametru
Typ: String
Default value: None Podporuje zástupné znaky: False DontShow: False
Sady parametrů
NameSasPermission
Position: 0 Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
NameSasPolicy
Position: 0 Povinné: True Hodnota z kanálu: True Hodnota z kanálu podle názvu vlastnosti: True Hodnota ze zbývajících argumentů: False
-StartTime
Určuje čas, kdy se sdílený přístupový podpis stane platným.
Vlastnosti parametru
Sady parametrů
(All)
Position: Named Povinné: False Hodnota z kanálu: False Hodnota z kanálu podle názvu vlastnosti: False Hodnota ze zbývajících argumentů: False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters .
Výstupy
