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

New-AzStorageFileSymbolicLink

模块:
Az.Storage Module

创建指向指定文件的符号链接。 仅适用于 NFS 文件共享。

语法

ShareName (默认值) 

New-AzStorageFileSymbolicLink
    [-ShareName] <String>
    [-Path] <String>
    [-LinkText] <String>
    [-Metadata <Hashtable>]
    [-FileCreatedOn <DateTimeOffset>]
    [-FileLastWrittenOn <DateTimeOffset>]
    [-Owner <String>]
    [-Group <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Share 

New-AzStorageFileSymbolicLink
    [-ShareClient] <ShareClient>
    [-Path] <String>
    [-LinkText] <String>
    [-Metadata <Hashtable>]
    [-FileCreatedOn <DateTimeOffset>]
    [-FileLastWrittenOn <DateTimeOffset>]
    [-Owner <String>]
    [-Group <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Directory 

New-AzStorageFileSymbolicLink
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [-Path] <String>
    [-LinkText] <String>
    [-Metadata <Hashtable>]
    [-FileCreatedOn <DateTimeOffset>]
    [-FileLastWrittenOn <DateTimeOffset>]
    [-Owner <String>]
    [-Group <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzStorageFileSymbolicLink cmdlet 创建指向Azure文件共享中的文件的符号链接。 此 cmdlet 仅适用于 NFS 文件共享。 符号链接是指向另一个文件或目录的文件。 符号链接可以使用相对路径或绝对路径指向同一文件共享中的文件，甚至指向文件共享外部的文件。

示例

示例 1：创建包含所有可选参数的符号链接

$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
New-AzStorageFileSymbolicLink -ShareName "nfsshare" -Path "links/testlink" -LinkText "config/app.conf" -Metadata @{ "meta1"="value1";"meta2"="value2"} -FileCreatedOn "2025-09-01T00:00:00Z" -FileLastWrittenOn "2025-09-15T12:00:00Z" -Owner "1000" -Group "1000" -Context $ctx

此命令创建包含所有可用可选参数的符号链接。符号链接指向相对路径“config/app.conf”。

示例 2：使用 ShareClient 对象创建符号链接

$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$shareClient = Get-AzStorageShare -Name "nfsshare" -Context $ctx
$shareClient | New-AzStorageFileSymbolicLink -Path "dir1/app-link" -LinkText "config/app.conf"

此命令使用从 Get-AzStorageShare 获取的 ShareClient 对象创建符号链接。

示例 3：使用目录客户端创建符号链接

$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$dirClient = Get-AzStorageFile -ShareName "nfsshare" -Path "testdir" -Context $ctx
$dirClient | New-AzStorageFileSymbolicLink -Path "testlink" -LinkText "app/main.exe"

此命令使用 ShareDirectoryClient 对象在特定目录中创建符号链接。

参数

-ClientTimeoutPerRequest

客户端每个请求的最大执行时间（以秒为单位）。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:ClientTimeoutPerRequestInSeconds

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ConcurrentTaskCount

并发异步任务的总数。 默认值为 10。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:Cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Context

Azure 存储上下文对象

参数属性

类型:IStorageContext
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-DefaultProfile

用于与Azure通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FileCreatedOn

符号链接的创建时间。

参数属性

类型:

Nullable<T>[DateTimeOffset]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FileLastWrittenOn

符号链接的最后一次写入时间。

参数属性

类型:

Nullable<T>[DateTimeOffset]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Group

可选。 要设置在符号链接上的所有者组标识符（GID）。 默认值为 0（根组）。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-LinkText

要链接到的文件的绝对路径或相对路径。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:2
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Metadata

要为符号链接设置的可选自定义元数据。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Owner

可选。 要设置在符号链接上的所有者用户标识符（UID）。 默认值为 0（root）。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Path

要创建的符号链接的路径。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ServerTimeoutPerRequest

服务器为每个请求超时（以秒为单位）。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:ServerTimeoutPerRequestInSeconds

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShareClient

ShareClient 对象指示将在其中创建符号链接的共享。

参数属性

类型:ShareClient
默认值:None
支持通配符:False
不显示:False

参数集

Share
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ShareDirectoryClient

ShareDirectoryClient 对象指示将在其中创建符号链接的基文件夹。

参数属性

类型:ShareDirectoryClient
默认值:None
支持通配符:False
不显示:False

参数集

Directory
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ShareName

要在其中创建符号链接的文件共享的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ShareName
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

ShareClient

ShareDirectoryClient

String

IStorageContext

输出

AzureStorageFile

备注

  • 此 cmdlet 仅适用于 NFS 文件共享
  • 符号链接可以指向同一共享或外部位置中的文件
  • 符号链接将在目录列表中显示为常规文件，但包含对目标路径的引用