HOWTO · PowerShell

Asignación de una unidad SMB mediante PowerShell

En este artículo, aprenderemos sobre el comando de uso de red heredado y su contraparte de comando similar New-SMBMapping en Windows PowerShell.

En esta página

Para acceder a un recurso compartido de archivos de Windows mediante una letra de unidad, asigna su ruta UNC (por ejemplo, \\FileServer\SharedFolder) con el cmdlet de PowerShell New-SMBMapping o el comando net use. Sustituye el servidor, el recurso compartido y la letra de unidad de los ejemplos por los valores que te proporcione el administrador de red. SMB es el protocolo para compartir archivos; la asignación permite acceder a una ubicación de red compartida mediante una ruta de unidad local.

Asignar un recurso compartido SMB con New-SMBMapping

En PowerShell, New-SMBMapping crea una asignación entre una ruta de unidad local y un recurso compartido remoto. LocalPath es la letra de unidad, como Z:, y RemotePath es la ruta UNC del recurso compartido. Un comando habitual es New-SMBMapping -LocalPath Z: -RemotePath \\ServerName\SharedFolder. Ejecútalo en una sesión de Windows PowerShell donde esté disponible el cmdlet y utiliza una ruta de recurso compartido y permisos válidos para tu entorno.

El siguiente ejemplo breve muestra una vista previa del comando con los valores de muestra. No se conecta a ningún servidor; copia el comando mostrado en una sesión de Windows PowerShell adecuada después de sustituir los marcadores de posición.

Ejecuta este ejemplo. El código y la salida del comando se conservan en inglés.

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

$drive = 'Z:'
$share = '\\ServerName\SharedFolder'
"New-SMBMapping -LocalPath $drive -RemotePath '$share'"
New-SMBMapping -LocalPath Z: -RemotePath '\\ServerName\SharedFolder'

Esta vista previa mantiene juntas la letra de unidad y la ruta UNC para que puedas revisar los valores antes de ejecutar el comando de asignación. Para establecer una conexión real, ejecuta el comando en sí, no el script de vista previa.

Asignar un recurso compartido SMB con net use

net use es una alternativa de línea de comandos de Windows para crear y ver conexiones de red. Por ejemplo, net use F: \\FS01\c$ asigna el recurso compartido \\FS01\c$ a la unidad F:. El carácter $ forma parte del nombre del recurso compartido; los recursos compartidos administrativos pueden requerir permisos distintos de los de los recursos compartidos normales.

También puedes pedirle a Windows que elija una letra de unidad disponible con net use * \\FS01\SharedFolder. Es práctico cuando no importa una letra concreta, pero anota cuál asigna Windows para poder referirte después a esa asignación. Para evitar que una contraseña quede expuesta en el historial de comandos o en los detalles del proceso, no la añadas literalmente al comando. Si se necesita autenticación, utiliza el método de credenciales aprobado por tu organización y sigue sus indicaciones para el aviso interactivo o el contexto de la cuenta.

Elegir una letra de unidad y especificar una ruta de recurso compartido

Usa una letra de unidad que esté libre en la sesión de Windows donde vayas a utilizar el recurso compartido. La ubicación remota debe ser una ruta UNC que empiece con dos barras invertidas, seguidas del nombre del servidor y del recurso compartido, como \\FileServer\Team Files. Si la ruta contiene espacios, pon entre comillas el argumento de la ruta para que se pase como un solo valor; por ejemplo, New-SMBMapping -LocalPath Z: -RemotePath '\\FileServer\Team Files'.

La ruta apunta a una carpeta compartida, no necesariamente a todo el disco de un servidor. Confirma el nombre exacto del recurso compartido con el responsable del servidor. Una asignación de unidad está asociada al usuario y al contexto de sesión que la crea, así que puede que no aparezca en otro contexto.

Verificar y administrar asignaciones SMB

Después de crear una asignación, revisa las conexiones actuales en lugar de confiar únicamente en un mensaje de éxito. El cmdlet Get-SMBMapping muestra las asignaciones SMB; net use también muestra las conexiones de red. Comprueba que las rutas locales de unidad y las rutas UNC remotas coincidan con los valores previstos; después, abre la unidad o enumera su contenido para confirmar que tu cuenta puede acceder al recurso compartido.

Para quitar una asignación creada para Z:, usa Remove-SMBMapping -LocalPath Z:. El comando heredado puede desconectarla con net use Z: /delete. Estos comandos afectan a la asignación seleccionada, así que confirma la letra de unidad antes de quitarla. Si no puedes acceder, comprueba que el servidor y el recurso compartido estén escritos correctamente, que la red sea accesible, que la cuenta tenga permisos y que la sesión actual use las credenciales previstas. Consulta la ayuda instalada con Get-Help New-SMBMapping -Full o Get-Help Remove-SMBMapping -Full para ver las opciones disponibles en ese sistema.

Persistencia, credenciales y limitaciones habituales

Las opciones de persistencia y credenciales pueden depender de la versión de Windows, de la implementación del cmdlet y del contexto de la cuenta. No des por hecho que una asignación se volverá a conectar después de iniciar sesión o reiniciar el equipo basándote únicamente en un ejemplo de comando. Consulta la ayuda del comando instalado y las indicaciones de Windows de tu organización para conocer las opciones y el comportamiento admitidos.

Evita incluir contraseñas reutilizables directamente en scripts, ejemplos de artículos o comandos que puedan guardarse en el historial. Usa el proceso de credenciales aprobado para tu entorno y pregunta a un administrador si la cuenta tiene autorización para acceder al recurso compartido. Si una asignación no está disponible en una tarea programada, una sesión con privilegios elevados o la sesión de otro usuario, comprueba qué identidad y contexto de inicio de sesión utiliza ese proceso. Estos ejemplos muestran la estructura de los comandos; no afirman que se haya probado una conexión con un servidor o una configuración de Windows específicos.