你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzDataLakeGen2SasToken

为 Azure DatalakeGen2 项生成 SAS 令牌。

语法

New-AzDataLakeGen2SasToken
   [-FileSystem] <String>
   [-Path <String>]
   [-Permission <String>]
   [-Protocol <SasProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTimeOffset>]
   [-ExpiryTime <DateTimeOffset>]
   [-EncryptionScope <String>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDataLakeGen2SasToken
   -InputObject <AzureDataLakeGen2Item>
   [-Permission <String>]
   [-Protocol <SasProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTimeOffset>]
   [-ExpiryTime <DateTimeOffset>]
   [-EncryptionScope <String>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzDataLakeGen2SasToken cmdlet 为 Azure DatalakeGen2 项生成共享访问签名 (SAS) 令牌。

示例

示例 1:生成具有完全权限的 SAS 令牌

New-AzDataLakeGen2SasToken -FileSystem "filesystem1" -Path "dir1/dir2" -Permission racwdlmeop

此示例生成具有完全权限的 DatalakeGen2 SAS 令牌。

示例 2:通过管道 datalakegen2 项目生成具有特定 StartTime、ExpireTime、Protocal、IPAddressOrRange、加密范围的 SAS 令牌

Get-AzDataLakeGen2Item -FileSystem test -Path "testdir/dir2" | New-AzDataLakeGen2SasToken -Permission rw -Protocol Https -IPAddressOrRange 10.0.0.0-12.10.0.0 -StartTime (Get-Date) -ExpiryTime (Get-Date).AddDays(6) -EncryptionScope scopename

此示例通过管道 datalake gen2 项生成 DatalakeGen2 SAS 令牌,并使用特定的 StartTime、ExpireTime、Protocal、IPAddressOrRange、Encryption Scope。

参数

-Context

Azure 存储上下文对象

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

-EncryptionScope

发送经此 SAS URI 授权的请求时要使用的加密范围。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpiryTime

到期时间

Type:Nullable<T>[DateTimeOffset]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileSystem

FileSystem 名称

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-FullUri

使用 sas 令牌显示完整 URI

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

要删除的 Azure Datalake Gen2 项对象。

Type:AzureDataLakeGen2Item
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IPAddressOrRange

Azure 存储接受请求的 IP 或 IP 范围 ACL (访问控制列表)。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

应检索的指定 FileSystem 中的路径。 可以是文件或目录,格式为“directory/file.txt”或“directory1/directory2/”。 跳过设置此参数以获取文件系统的根目录。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Permission

Blob 的权限。 权限可以是“racwdlmeop”的任何非空子集。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

协议可以在请求中使用此 SAS 令牌。

Type:Nullable<T>[SasProtocol]
Accepted values:None, HttpsAndHttp, Https
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

Start Time

Type:Nullable<T>[DateTimeOffset]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

AzureDataLakeGen2Item

IStorageContext

输出

String