Get-AzStorageFileSymbolicLink

Modul:
Az.Storage Module

Ruft die Eigenschaften einer symbolischen Verknüpfung ab. Funktioniert nur in der NFS-Dateifreigabe.

Syntax

ShareName (Standard) 

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

Beschreibung

Das Cmdlet Get-AzStorageFileSymbolicLink ruft die Eigenschaften und den Zielpfad einer symbolischen Verknüpfung in einer Azure Dateifreigabe ab. Dieses Cmdlet funktioniert nur mit NFS-Dateifreigaben.

Beispiele

Beispiel 1: Abrufen symbolischer Verknüpfungseigenschaften mithilfe des Freigabenamens

$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

Mit diesem Befehl werden die Eigenschaften einer symbolischen Verknüpfung namens "mylink" im Verzeichnis "links" der NFS-Dateifreigabe "nfsshare" abgerufen.

Beispiel 2: Abrufen mehrerer symbolischer Verknüpfungen in einem Verzeichnis

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

Dieser Befehl listet zuerst alle Dateien im Verzeichnis "linkdir" auf und filtert dann alle Dateien, die symbolische Verknüpfung sind, und ruft schließlich symbolische Verknüpfungseigenschaften für jede Datei ab.

Beispiel 3: Abrufen symbolischer Verknüpfungen mithilfe der ShareClient-Pipeline

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

Dieser Befehl ruft eine symbolische Verknüpfung mit einem ShareClient-Objekt ab, das von Get-AzStorageShare abgerufen wird und die Pipelineverwendung mit dem Parametersatz "Share" veranschaulicht.

Beispiel 4: Abrufen symbolischer Verknüpfung mithilfe der ShareDirectoryClient-Pipeline

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

Dieser Befehl ruft eine symbolische Verknüpfung innerhalb eines bestimmten Verzeichnisses mithilfe eines ShareDirectoryClient-Objekts ab, das die Pipelineverwendung mit dem Parametersatz Directory veranschaulicht.

Parameter

-ClientTimeoutPerRequest

Die clientseitige maximale Ausführungszeit für jede Anforderung in Sekunden.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ClientTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConcurrentTaskCount

Die Gesamtmenge der gleichzeitigen asynchronen Vorgänge. Der Standardwert ist 10.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Context

Azure Storage Context-Objekt

Parametereigenschaften

Typ:IStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Pfad der abzurufenden symbolischen Verknüpfungsdatei.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServerTimeoutPerRequest

Der Servertimeout für jede Anforderung in Sekunden.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ServerTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShareClient

ShareClient-Objekt, das die Freigabe angibt, die den symbolischen Link enthält.

Parametereigenschaften

Typ:ShareClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Share
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareDirectoryClient

ShareDirectoryClient-Objekt, das den Basisordner angibt, der die symbolische Verknüpfung enthält.

Parametereigenschaften

Typ:ShareDirectoryClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Directory
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareName

Name der Dateifreigabe, die den symbolischen Link enthält.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

ShareClient

ShareDirectoryClient

String

IStorageContext

Ausgaben

AzureStorageFile

Hinweise

  • Dieses Cmdlet funktioniert nur mit NFS-Dateifreigaben.
  • Das zurückgegebene Objekt enthält die symbolischen Verknüpfungseigenschaften, einschließlich des Zielpfads (LinkText)
  • Verwenden Sie die FileProperties.LinkText-Eigenschaft, um auf den Zielpfad der symbolischen Verknüpfung zuzugreifen.
  • Die FileProperties.IsSymbolicLink-Eigenschaft kann verwendet werden, um zu überprüfen, ob die Datei tatsächlich eine symbolische Verknüpfung ist.