New-AzStorageFileSASToken
產生記憶體檔案的共用存取簽章令牌。
語法
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-AzStorageFileSASToken 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-AzStorageContext Cmdlet。
類型: | IStorageContext |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ExpiryTime
指定共用存取簽章失效的時間。
類型: | Nullable<T>[DateTime] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-File
指定 CloudFile 物件。 您可以使用 Get-AzStorageFile Cmdlet 建立雲端檔案或取得雲端檔案。
類型: | CloudFile |
別名: | CloudFile |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-FullUri
指出此 Cmdlet 會傳回完整的 Blob URI 和共用存取簽章令牌。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IPAddressOrRange
指定要接受要求的IP位址或IP位址範圍,例如168.1.5.65或168.1.5.5.60-168.1.5.70。 範圍是內含的。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
指定檔案相對於記憶體共用的路徑。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Permission
指定記憶體檔案的許可權。
請務必注意,這是字串,例如 rwd
(針對讀取、寫入和刪除)。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Policy
指定檔案的預存存取原則。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Protocol
指定要求允許的通訊協定。 此參數可接受的值為:
- HttpsOnly
- HttpsOrHttp 預設值為 HttpsOrHttp。
類型: | Nullable<T>[SharedAccessProtocol] |
接受的值: | HttpsOnly, HttpsOrHttp |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ShareName
指定記憶體共用的名稱。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-StartTime
指定共用存取簽章生效的時間。
類型: | Nullable<T>[DateTime] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |