Get-AzStorageFileSymbolicLink

Modul:
Az.Storage Module

Lekéri egy szimbolikus hivatkozás tulajdonságait. Csak NFS-fájlmegosztásban működik.

Syntax

ShareName (Alapértelmezett) 

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>]

Description

A Get-AzStorageFileSymbolicLink parancsmag lekéri egy szimbolikus hivatkozás tulajdonságait és célútvonalát egy Azure-fájlmegosztásban. Ez a parancsmag csak NFS-fájlmegosztásokkal működik.

Példák

1. példa: Szimbolikus hivatkozástulajdonságok lekérése megosztásnév használatával

$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

Ez a parancs lekéri az "nfsshare" NFS-fájlmegosztás "links" könyvtárában a "mylink" nevű szimbolikus hivatkozás tulajdonságait.

2. példa: Több szimbolikus hivatkozás lekérése egy könyvtárban

$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))"
}

Ez a parancs először felsorolja a "linkdir" könyvtárban lévő összes fájlt, majd kiszűri a szimbolikus hivatkozásokat tartalmazó összes fájlt, végül az egyes fájlok szimbolikus hivatkozástulajdonságokat kapnak.

3. példa: Szimbolikus hivatkozás lekérése ShareClient-folyamattal

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

Ez a parancs egy szimbolikus hivatkozást kap a Get-AzStorageShare-ből beszerzett ShareClient-objektummal, amely bemutatja a folyamat használatát a Share paraméterkészlettel.

4. példa: Szimbolikus hivatkozás lekérése ShareDirectoryClient-folyamattal

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

Ez a parancs egy szimbolikus hivatkozást kap egy adott könyvtárban egy ShareDirectoryClient objektummal, amely a folyamat használatát mutatja be a Címtár paraméterkészlettel.

Paraméterek

-ClientTimeoutPerRequest

Az ügyféloldali maximális végrehajtási idő az egyes kérésekhez másodpercben.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ClientTimeoutPerRequestInSeconds

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ConcurrentTaskCount

Az egyidejű aszinkron tevékenységek teljes mennyisége. Az alapértelmezett érték 10.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Context

Azure Storage környezeti objektum

Paramétertulajdonságok

Típus:IStorageContext
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

A lekérendő szimbolikus hivatkozásfájl elérési útja.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:1
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ServerTimeoutPerRequest

A kiszolgáló másodpercek alatt időtúllépést hajt végre az egyes kérések esetében.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ServerTimeoutPerRequestInSeconds

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ShareClient

A szimbolikus hivatkozást tartalmazó megosztást jelző ShareClient-objektum.

Paramétertulajdonságok

Típus:ShareClient
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Share
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ShareDirectoryClient

ShareDirectoryClient objektum, amely a szimbolikus hivatkozást tartalmazó alapmappát jelzi.

Paramétertulajdonságok

Típus:ShareDirectoryClient
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Directory
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ShareName

A szimbolikus hivatkozást tartalmazó fájlmegosztás neve.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ShareName
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

ShareClient

ShareDirectoryClient

String

IStorageContext

Kimenetek

AzureStorageFile

Jegyzetek

  • Ez a parancsmag csak NFS-fájlmegosztásokkal működik
  • A visszaadott objektum tartalmazza a szimbolikus hivatkozás tulajdonságait, beleértve a cél elérési útját (LinkText)
  • A FileProperties.LinkText tulajdonság használata a szimbolikus hivatkozás célútvonalának eléréséhez
  • A FileProperties.IsSymbolicLink tulajdonság használható annak ellenőrzésére, hogy a fájl valóban szimbolikus hivatkozás-e