New-AzStorageFileSASToken

Modul:

Az.Storage

Vygeneruje token sdíleného přístupového podpisu pro soubor úložiště.

Syntaxe

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>]

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 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

-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, jako je 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. Přijatelné hodnoty pro tento parametr jsou:

• HttpsOnly
• HttpsOrHttp Výchozí hodnota je HttpsOrHttp.

Typ:	String
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

-ShareFileClient

Instance ShareFileClient, která představuje soubor pro získání tokenu SAS.

Typ:	ShareFileClient
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
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

String

ShareFileClient

IStorageContext

Výstupy

String

Související odkazy

• New-AzStorageContext
• New-AzStorageShareSASToken