New-AzStorageFileSASToken
產生 儲存體 檔案的共用存取簽章令牌。
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
New-Az 儲存體 FileSASToken Cmdlet 會產生 Azure 儲存體 檔案的共用存取簽章令牌。
範例
範例 1:產生具有完整檔案許可權的共用存取簽章令牌
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"
此命令會產生共用存取簽章令牌,此令牌具有名為 FilePath 之檔案的完整許可權。
範例 2:產生具有時間限制的共用存取簽章令牌
$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime
第一個命令會使用 Get-Date Cmdlet 建立 DateTime 物件。 命令會將目前時間儲存在 $StartTime 變數中。 第二個命令會將兩個小時新增至 $StartTime 中的 對象,然後將結果儲存在$EndTime變數中。 此對像是未來兩個小時的時間。 第三個命令會產生具有指定許可權的共用存取簽章令牌。 此令牌會在目前時間生效。 令牌會維持有效狀態,直到儲存在$EndTime的時間為止。
參數
-Context
指定 Azure 儲存體 內容。 若要取得內容,請使用 New-Az 儲存體 Context Cmdlet。
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpiryTime
指定共用存取簽章失效的時間。
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-File
指定 CloudFile 物件。 您可以使用 Get-Az 儲存體 File Cmdlet 來建立雲端檔案或取得雲端檔案。
Type: | CloudFile |
Aliases: | CloudFile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FullUri
指出此 Cmdlet 會傳回完整的 Blob URI 和共用存取簽章令牌。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IPAddressOrRange
指定要接受要求的IP位址或IP位址範圍,例如168.1.5.65或168.1.5.5.60-168.1.5.70。 範圍是內含的。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
指定檔案相對於 儲存體 共用的路徑。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Permission
指定 儲存體 檔案的許可權。
請務必注意,這是字串,例如 rwd
(針對讀取、寫入和刪除)。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Policy
指定檔案的預存存取原則。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
指定要求允許的通訊協定。 此參數可接受的值為:
- HttpsOnly
- HttpsOrHttp 預設值為 HttpsOrHttp。
Type: | Nullable<T>[SharedAccessProtocol] |
Accepted values: | HttpsOnly, HttpsOrHttp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShareName
指定 儲存體 共用的名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StartTime
指定共用存取簽章生效的時間。
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
輸出
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應