New-AzStorageFileSASToken

Létrehoz egy megosztott hozzáférésű jogosultságkód-jogkivonatot egy Storage-fájlhoz.

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

A New-AzStorageFileSASToken parancsmag létrehoz egy közös hozzáférésű jogosultságkód-jogkivonatot egy Azure Storage fájlhoz.

Példák

1. példa: Teljes fájlengedélyekkel rendelkező közös hozzáférésű jogosultságkód-jogkivonat létrehozása

New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

Ez a parancs létrehoz egy közös hozzáférésű jogosultságkód-jogkivonatot, amely teljes engedélyekkel rendelkezik a FilePath nevű fájlhoz.

2. példa: Időkorláttal rendelkező közös hozzáférésű jogosultságkód-jogkivonat létrehozása

$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

Az első parancs létrehoz egy DateTime-objektumot a Get-Date parancsmag használatával. A parancs az aktuális időt a $StartTime változóban tárolja. A második parancs két órát ad hozzá az objektumhoz $StartTime, majd az eredményt a $EndTime változóban tárolja. Ez az objektum a jövőben két óra. A harmadik parancs létrehoz egy megosztott hozzáférésű jogosultságkód-jogkivonatot, amely rendelkezik a megadott engedélyekkel. Ez a jogkivonat az aktuális időpontban válik érvényessé. A jogkivonat a $EndTime tárolt időig érvényes marad.

Paraméterek

-Context

Egy Azure Storage környezetet határoz meg. Környezet beszerzéséhez használja a New-AzStorageContext parancsmagot.

Paramétertulajdonságok

Típus:IStorageContext
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-DefaultProfile

A Azure való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ExpiryTime

Azt az időpontot adja meg, amikor a közös hozzáférésű jogosultságkód érvénytelenné válik.

Paramétertulajdonságok

Típus:

Nullable<T>[DateTime]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-FullUri

Azt jelzi, hogy ez a parancsmag a teljes blob URI-t és a közös hozzáférésű jogosultságkód-jogkivonatot adja vissza.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IPAddressOrRange

Azt az IP-címet vagy IP-címtartományt adja meg, amelyből kérelmeket fogadhat el, például 168.1.5.65 vagy 168.1.5.60-168.1.5.70. A tartomány befogadó.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

A fájl tárolási megosztáshoz viszonyított elérési útját adja meg.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

NameSasPermission
Position:1
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False
NameSasPolicy
Position:1
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Permission

Megadja egy Storage-fájl engedélyeit. Fontos megjegyezni, hogy ez egy sztring, például rwd (olvasás, írás és törlés).

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

NameSasPermission
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FileSasPermission
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Policy

Egy fájl tárolt hozzáférési szabályzatát adja meg.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

NameSasPolicy
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FileSasPolicy
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Protocol

Megadja a kéréshez engedélyezett protokollt. A paraméter elfogadható értékei a következők:

  • HttpsOnly
  • HttpsOrHttp Az alapértelmezett érték a HttpsOrHttp.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:HttpsOnly, HttpsOrHttp
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ShareFileClient

ShareFileClient-példány, amely az SAS-jogkivonat lekéréséhez használt fájlt jelöli.

Paramétertulajdonságok

Típus:ShareFileClient
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

FileSasPermission
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False
FileSasPolicy
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ShareName

Megadja a Storage-megosztás nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

NameSasPermission
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False
NameSasPolicy
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-StartTime

Azt az időpontot adja meg, amikor a közös hozzáférésű jogosultságkód érvényessé válik.

Paramétertulajdonságok

Típus:

Nullable<T>[DateTime]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

ShareFileClient

IStorageContext

Kimenetek

String