New-AzStorageFileSymbolicLink

Modul:
Az.Storage Module

Vytvoří symbolický odkaz na zadaný soubor. Funguje jenom ve sdílené složce NFS.

Syntax

ShareName (Výchozí) 

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

Description

Rutina New-AzStorageFileSymbolicLink vytvoří symbolický odkaz na soubor ve sdílené složce Azure. Tato rutina funguje jenom se sdílenými složkami NFS. Symbolický odkaz je soubor, který odkazuje na jiný soubor nebo adresář. Symbolický odkaz může odkazovat na soubory ve stejné sdílené složce nebo dokonce mimo sdílenou složku pomocí relativních nebo absolutních cest.

Příklady

Příklad 1: Vytvoření symbolického odkazu se všemi volitelnými parametry

$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

Tento příkaz vytvoří symbolický odkaz se všemi dostupnými volitelnými parametry. Symbolický odkaz odkazuje na relativní cestu config/app.conf.

Příklad 2: Vytvoření symbolického odkazu pomocí objektu 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"

Tento příkaz vytvoří symbolický odkaz pomocí objektu ShareClient získaného z Get-AzStorageShare.

Příklad 3: Vytvoření symbolického odkazu pomocí klienta adresáře

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

Tento příkaz vytvoří symbolický odkaz v určitém adresáři pomocí objektu ShareDirectoryClient.

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

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

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

-FileCreatedOn

Čas vytvoření symbolického odkazu.

Vlastnosti parametru

Typ:

Nullable<T>[DateTimeOffset]

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

-FileLastWrittenOn

Čas posledního zápisu symbolického odkazu.

Vlastnosti parametru

Typ:

Nullable<T>[DateTimeOffset]

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

-Group

Optional. Identifikátor skupiny vlastníka (GID), který se má nastavit na symbolickém odkazu. Výchozí hodnota je 0 (kořenová skupina).

Vlastnosti parametru

Typ:String
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

-LinkText

Absolutní nebo relativní cesta k souboru, ke které se má propojit.

Vlastnosti parametru

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

Sady parametrů

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

-Metadata

Volitelná vlastní metadata, která se mají nastavit pro symbolický odkaz.

Vlastnosti parametru

Typ:Hashtable
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

-Owner

Optional. Identifikátor uživatele vlastníka (UID), který se má nastavit na symbolickém odkazu. Výchozí hodnota je 0 (kořen).

Vlastnosti parametru

Typ:String
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

-Path

Cesta symbolického odkazu, který se má vytvořit.

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čil sdílenou složku, kde by byl vytvořen 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

Objekt ShareDirectoryClient označil základní složku, kde by byl vytvořen 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, kde by se vytvořil 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

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

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

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.
  • Symbolické odkazy můžou odkazovat na soubory ve stejné sdílené nebo externí lokalitě.
  • Symbolický odkaz se zobrazí jako běžný soubor ve výpisech adresářů, ale obsahuje odkaz na cílovou cestu.