New-AzureStorageShareSASToken
為 Azure 儲存體 共用產生共用存取簽章令牌。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
New-AzureStorageShareSASToken
[-ShareName] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureStorageShareSASToken
[-ShareName] <String>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
New-AzureStorageShareSASToken Cmdlet 會產生 Azure 儲存體 共用的共用存取簽章令牌。
範例
範例 1：產生共用的共用存取簽章令牌
PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"此命令會為名為 ContosoShare 的共用建立共用存取簽章令牌。
範例 2：使用管線產生多個共用存取簽章令牌
PS C:\>Get-AzureStorageShare -Prefix "test" | New-AzureStorageShareSASToken -Permission "rwdl"此命令會取得符合前置詞測試的所有記憶體共用。 命令會使用管線運算符將它們傳遞至目前的 Cmdlet。 目前的 Cmdlet 會為每個具有指定許可權的記憶體共用建立共用存取令牌。
範例 3：產生使用共用存取原則的共用存取簽章令牌
PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"此命令會為名為 ContosoShare 且原則為 ContosoPolicy03 的記憶體共用建立共用存取簽章令牌。
參數
-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 |
-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 |
-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 |
| 別名: | N, Name |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StartTime
指定共用存取簽章生效的時間。
| 類型: | Nullable<T>[DateTime] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
輸出
備註
- 關鍵詞：common、azure、services、data、storage、blob、queue、table