New-AzStorageShareSASToken

  • 參考
模組:
Az.Storage

為 Azure 儲存體 共用產生共用存取簽章令牌。

Syntax

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

Description

New-Az 儲存體 ShareSASToken Cmdlet 會產生 Azure 儲存體 共用的共用存取簽章令牌。

範例

範例 1：產生共用的共用存取簽章令牌

New-AzStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

此命令會為名為 ContosoShare 的共用建立共用存取簽章令牌。

範例 2：使用管線產生多個共用存取簽章令牌

Get-AzStorageShare -Prefix "test" | New-AzStorageShareSASToken -Permission "rwdl"

此命令會取得符合前置詞測試的所有 儲存體 共用。 命令會使用管線運算符將它們傳遞至目前的 Cmdlet。 目前的 Cmdlet 會為每個具有指定許可權的 儲存體 共用建立共用存取令牌。

範例 3：產生使用共用存取原則的共用存取簽章令牌

New-AzStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

此命令會為名為 ContosoShare 且具有名為 ContosoPolicy03 的原則之 儲存體 共用建立共用存取簽章令牌。

參數

-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

-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

-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
Aliases:N, Name
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

輸入

String

IStorageContext

輸出

String

備註

  • 關鍵詞：common、azure、services、data、storage、blob、queue、table