Compartir a través de

New-AzStorageFileSymbolicLink

Módulo:
Az.Storage Module

Crea un vínculo simbólico a un archivo especificado. Solo funciona en el recurso compartido de archivos NFS.

Sintaxis

ShareName (valor predeterminado) 

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

El cmdlet New-AzStorageFileSymbolicLink crea un vínculo simbólico a un archivo en un recurso compartido de archivos de Azure. Este cmdlet solo funciona con recursos compartidos de archivos NFS. Un vínculo simbólico es un archivo que apunta a otro archivo o directorio. El vínculo simbólico puede apuntar a archivos del mismo recurso compartido de archivos o incluso fuera del recurso compartido de archivos mediante rutas de acceso relativas o absolutas.

Ejemplos

Ejemplo 1: Crear un vínculo simbólico con todos los parámetros opcionales

$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

Este comando crea un vínculo simbólico con todos los parámetros opcionales disponiblesEl vínculo simbólico apunta a una ruta de acceso relativa "config/app.conf".

Ejemplo 2: Crear un vínculo simbólico mediante el objeto 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"

Este comando crea un vínculo simbólico mediante un objeto ShareClient obtenido de Get-AzStorageShare.

Ejemplo 3: Creación de un vínculo simbólico mediante el cliente de directorio

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

Este comando crea un vínculo simbólico dentro de un directorio específico mediante un objeto ShareDirectoryClient.

Parámetros

-ClientTimeoutPerRequest

Tiempo máximo de ejecución del lado cliente para cada solicitud en segundos.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConcurrentTaskCount

Cantidad total de tareas asincrónicas simultáneas. El valor predeterminado es 10.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Context

Objeto de contexto de Azure Storage

Propiedades de parámetro

Tipo:IStorageContext
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FileCreatedOn

Hora de creación del vínculo simbólico.

Propiedades de parámetro

Tipo:

Nullable<T>[DateTimeOffset]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FileLastWrittenOn

Hora de última escritura del vínculo simbólico.

Propiedades de parámetro

Tipo:

Nullable<T>[DateTimeOffset]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Group

Optional. Identificador de grupo propietario (GID) que se va a establecer en el vínculo simbólico. El valor predeterminado es 0 (grupo raíz).

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LinkText

Ruta de acceso absoluta o relativa al archivo al que se va a vincular.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Metadata

Metadatos personalizados opcionales que se van a establecer para el vínculo simbólico.

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Owner

Optional. Identificador de usuario del propietario (UID) que se va a establecer en el vínculo simbólico. El valor predeterminado es 0 (raíz).

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Path

Ruta de acceso del vínculo simbólico que se va a crear.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ServerTimeoutPerRequest

Tiempo de espera del servidor para cada solicitud en segundos.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShareClient

El objeto ShareClient indicó el recurso compartido donde se crearía el vínculo simbólico.

Propiedades de parámetro

Tipo:ShareClient
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Share
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ShareDirectoryClient

El objeto ShareDirectoryClient indicó la carpeta base donde se crearía el vínculo simbólico.

Propiedades de parámetro

Tipo:ShareDirectoryClient
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Directory
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ShareName

Nombre del recurso compartido de archivos donde se crearía el vínculo simbólico.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ShareName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

ShareClient

ShareDirectoryClient

String

IStorageContext

Salidas

AzureStorageFile

Notas

  • Este cmdlet solo funciona con recursos compartidos de archivos NFS
  • Los vínculos simbólicos pueden apuntar a archivos dentro del mismo recurso compartido o ubicaciones externas.
  • El vínculo simbólico aparecerá como un archivo normal en las listas de directorios, pero contiene una referencia a la ruta de acceso de destino.