Get-AzStorageFileSymbolicLink

Modul:
Az.Storage Module

Získá vlastnosti symbolického odkazu. Funguje jenom ve sdílené složce NFS.

Syntax

ShareName (Výchozí) 

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

Rutina Get-AzStorageFileSymbolicLink načte vlastnosti a cílovou cestu symbolického odkazu ve sdílené složce Azure. Tato rutina funguje jenom se sdílenými složkami NFS.

Příklady

Příklad 1: Získání symbolických vlastností odkazu pomocí názvu sdílené složky

$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

Tento příkaz získá vlastnosti symbolického odkazu s názvem "mylink" v adresáři "links" sdílené složky NFS "nfsshare".

Příklad 2: Získání více symbolických odkazů v adresáři

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

Tento příkaz nejprve vypíše všechny soubory v adresáři "linkdir" a pak vyfiltruje všechny soubory, které jsou symbolické odkazy, nakonec získá symbolické vlastnosti propojení pro každý soubor.

Příklad 3: Získání symbolického odkazu pomocí kanálu ShareClient

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

Tento příkaz získá symbolický odkaz pomocí objektu ShareClient získaného z Get-AzStorageShare, který demonstruje využití kanálu se sadou parametrů Share.

Příklad 4: Získání symbolického odkazu pomocí kanálu ShareDirectoryClient

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

Tento příkaz získá symbolický odkaz v rámci konkrétního adresáře pomocí objektu ShareDirectoryClient, který demonstruje použití kanálu se sadou parametrů Directory.

Parametry

-ClientTimeoutPerRequest

Maximální doba provádění na straně klienta pro každý požadavek v sekundách.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ConcurrentTaskCount

Celkový počet souběžných asynchronních úloh. Výchozí hodnota je 10.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Context

kontextový objekt Azure Storage

Vlastnosti parametru

Typ:IStorageContext
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Cesta k symbolickému souboru odkazu, který se má načíst.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ServerTimeoutPerRequest

Časový limit serveru pro každý požadavek v sekundách vypršel.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ShareClient

Objekt ShareClient označující sdílenou složku obsahující symbolický odkaz.

Vlastnosti parametru

Typ:ShareClient
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Share
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ShareDirectoryClient

ShareDirectoryClient objekt označující základní složku obsahující symbolický odkaz.

Vlastnosti parametru

Typ:ShareDirectoryClient
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Directory
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ShareName

Název sdílené složky obsahující symbolický odkaz

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ShareName
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

ShareClient

ShareDirectoryClient

String

IStorageContext

Výstupy

AzureStorageFile

Poznámky

  • Tato rutina funguje jenom se sdílenými složkami NFS.
  • Vrácený objekt obsahuje symbolické vlastnosti propojení včetně cílové cesty (LinkText).
  • Použití FileProperties.LinkText vlastnost pro přístup k cílové cestě symbolického odkazu
  • Vlastnost FileProperties.IsSymbolicLink lze použít k ověření, zda je soubor skutečně symbolickým odkazem.