共用方式為

New-AzureStorageFileSASToken

  • 參考
模組:
Azure.Storage

產生記憶體檔案的共用存取簽章令牌。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   -File <CloudFile>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   -File <CloudFile>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzureStorageFileSASToken Cmdlet 會產生 Azure 儲存體 檔案的共用存取簽章令牌。

範例

範例 1：產生具有完整檔案許可權的共用存取簽章令牌

PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

此命令會產生共用存取簽章令牌，此令牌具有名為 FilePath 之檔案的完整許可權。

範例 2：產生具有時間限制的共用存取簽章令牌

PS C:\> $StartTime = Get-Date
PS C:\> $EndTime = $StartTime.AddHours(2.0)
PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

第一個命令會使用 Get-Date Cmdlet 建立 DateTime 物件。 命令會將目前時間儲存在 $StartTime 變數中。 第二個命令會將兩個小時新增至 $StartTime 中的 對象，然後將結果儲存在$EndTime變數中。 此對像是未來兩個小時的時間。 第三個命令會產生具有指定許可權的共用存取簽章令牌。 此令牌會在目前時間生效。 令牌會維持有效狀態，直到儲存在$EndTime的時間為止。

參數

-Context

指定 Azure 儲存體 內容。 若要取得內容，請使用 New-AzureStorageContext 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-AzureStorageFile Cmdlet 來建立雲端檔案或取得雲端檔案。

類型: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

輸入

String

CloudFile

IStorageContext

參數：內容（ByValue）

輸出

String