Поделиться через

Get-AzStorageFileSymbolicLink

Модуль:
Az.Storage Module

Возвращает свойства символьной ссылки. Работает только в общей папке NFS.

Синтаксис

ShareName (по умолчанию) 

Get-AzStorageFileSymbolicLink
    [-ShareName] <String>
    [-Path] <String>
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Share 

Get-AzStorageFileSymbolicLink
    [-ShareClient] <ShareClient>
    [-Path] <String>
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Directory 

Get-AzStorageFileSymbolicLink
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [-Path] <String>
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Описание

Командлет Get-AzStorageFileSymbolicLink извлекает свойства и целевой путь символьной ссылки в общей папке Azure. Этот командлет работает только с общими папками NFS.

Примеры

Пример 1. Получение свойств символьной ссылки с помощью имени общей папки

$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$link = Get-AzStorageFileSymbolicLink -ShareName "nfsshare" -Path "linkdir/mylink" -Context $ctx
$link
$link.FileProperties
$link.FileProperties.PosixProperties
$link.ShareFileSymbolicLinkInfo

AccountName: myaccount, ShareName: nfsshare

Type Length Name   Path
---- ------ ----   ----
File      0 mylink linkdir/mylink

LastModified          : 9/17/2025 8:36:43 AM +00:00
Metadata              : {}
ContentLength         : 13
ContentType           : application/octet-stream
ETag                  : "0x8DDF5C554DCC708"
ContentHash           :
ContentEncoding       :
CacheControl          :
ContentDisposition    :
ContentLanguage       :
CopyCompletedOn       : 1/1/0001 12:00:00 AM +00:00
CopyStatusDescription :
CopyId                :
CopyProgress          :
CopySource            :
CopyStatus            : Pending
IsServerEncrypted     : True
SmbProperties         : Azure.Storage.Files.Shares.Models.FileSmbProperties
LeaseDuration         : Infinite
LeaseState            : Available
LeaseStatus           : Unlocked
PosixProperties       : Azure.Storage.Files.Shares.Models.FilePosixProperties


FileMode  : rwxrwxrwx
Owner     : 0
Group     : 0
FileType  : SymLink
LinkCount : 1


ETag         : "0x8DDF5C554DCC708"
LastModified : 9/17/2025 8:36:43 AM +00:00
LinkText     : app%2Fmain.exe

Эта команда получает свойства символьной ссылки с именем mylink в каталоге "ссылки" общей папки NFS "nfsshare".

Пример 2. Получение нескольких символьных ссылок в каталоге

$files = Get-AzStorageFile -ShareName "nfsshare" -Path "linkdir" -Context $ctx | Get-AzStorageFile -ExcludeExtendedInfo
$symLinkFiles = $files | Where-Object {$_.FileProperties.PosixProperties.FileType.ToString() -eq "SymLink"}
foreach ($file in $symLinkFiles) {
    $symlink = Get-AzStorageFileSymbolicLink -ShareName "nfsshare"  -Path "linkdir/$($file.Name)" -Context $ctx
    Write-Output "$($file.Name) -> $([System.Web.HttpUtility]::UrlDecode($symlink.ShareFileSymbolicLinkInfo.LinkText))"
}

Эта команда сначала выводит список всех файлов в каталоге Linkdir, а затем отфильтруйте все файлы, которые являются символьной ссылкой, наконец, получает свойства символьной ссылки для каждого файла.

Пример 3. Получение символьной ссылки с помощью конвейера ShareClient

$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$shareClient = Get-AzStorageShare -Name "nfsshare" -Context $ctx
$link = $shareClient | Get-AzStorageFileSymbolicLink -Path "linkdir/mylink"

Эта команда получает символьную ссылку с помощью объекта ShareClient, полученного из Get-AzStorageShare, демонстрируя использование конвейера с набором параметров Share.

Пример 4. Получение символьной ссылки с помощью конвейера ShareDirectoryClient

$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$dirClient = Get-AzStorageFile -ShareName "nfsshare" -Path "linkdir" -Context $ctx
$link = $dirClient | Get-AzStorageFileSymbolicLink -Path "mylink"

Эта команда получает символьную ссылку в определенном каталоге с помощью объекта ShareDirectoryClient, демонстрируя использование конвейера с набором параметров каталога.

Параметры

-ClientTimeoutPerRequest

Максимальное время выполнения на стороне клиента для каждого запроса в секундах.

Свойства параметра

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ClientTimeoutPerRequestInSeconds

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConcurrentTaskCount

Общий объем параллельных асинхронных задач. Значение по умолчанию — 10.

Свойства параметра

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Context

Объект контекста службы хранилища Azure

Свойства параметра

Тип:IStorageContext
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Path

Путь к полученному файлу символьной ссылки.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ServerTimeoutPerRequest

Время ожидания сервера для каждого запроса в секундах.

Свойства параметра

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ServerTimeoutPerRequestInSeconds

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ShareClient

Объект ShareClient, указывающий общую папку, содержащую символьную ссылку.

Свойства параметра

Тип:ShareClient
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Share
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ShareDirectoryClient

Объект ShareDirectoryClient, указывающий базовую папку, содержащую символьную ссылку.

Свойства параметра

Тип:ShareDirectoryClient
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Directory
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ShareName

Имя общей папки, содержащей символьную ссылку.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareName
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

ShareClient

ShareDirectoryClient

String

IStorageContext

Выходные данные

AzureStorageFile

Примечания

  • Этот командлет работает только с общими папками NFS
  • Возвращаемый объект содержит свойства символьной ссылки, включая целевой путь (LinkText)
  • Использование свойства FileProperties.LinkText для доступа к целевому пути символьной ссылки
  • Свойство FileProperties.IsSymbolicLink можно использовать для проверки того, что файл является символьной ссылкой