New-AzStorageFileSASToken
Létrehoz egy megosztott hozzáférésű jogosultságkód-jogkivonatot egy Storage-fájlhoz.
Syntax
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
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 parancsmaggal. 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.
Típus: | IStorageContext |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ExpiryTime
Azt az időpontot adja meg, amikor a közös hozzáférésű jogosultságkód érvénytelenné válik.
Típus: | Nullable<T>[DateTime] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-File
CloudFile-objektumot ad meg. Létrehozhat egy felhőfájlt, vagy beszerezhet egyet a Get-AzStorageFile parancsmaggal.
Típus: | CloudFile |
Aliasok: | CloudFile |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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ó.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Path
A fájl tárolási megosztáshoz viszonyított elérési útját adja meg.
Típus: | String |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Policy
Egy fájl tárolt hozzáférési szabályzatát adja meg.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Nullable<T>[SharedAccessProtocol] |
Elfogadott értékek: | HttpsOnly, HttpsOrHttp |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ShareName
Megadja a Storage-megosztás nevét.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-StartTime
Azt az időpontot adja meg, amikor a közös hozzáférésű jogosultságkód érvényessé válik.
Típus: | Nullable<T>[DateTime] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |