New-SmbMapping 是 PowerShell 中用于创建 SMB（Server Message Block）共享映射的 cmdlet，通常用于在本地计算机上映射共享文件夹（通过 UNC 路径）。它可以帮助自动化文件共享的连接管理，常用于将网络共享映射为驱动器字母，或与域凭据进行集成。

New-SmbMapping 是 PowerShell 中用于创建 SMB（Server Message Block）共享映射的 cmdlet，通常用于在本地计算机上映射共享文件夹（通过 UNC 路径）。它可以帮助自动化文件共享的连接管理，常用于将网络共享映射为驱动器字母，或与域凭据进行集成。

以下是 New-SmbMapping 的功能分类表格，涵盖了其常见用法、参数以及如何根据不同需求使用该 cmdlet：

功能类别 功能描述 PowerShell 命令及参数 说明
创建 SMB 映射 映射一个共享路径到本地驱动器字母 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" 将网络共享路径 \\server\share 映射到本地的 Z: 驱动器。
指定凭据 使用特定的用户名和密码进行映射 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Credential (Get-Credential) 提示用户输入凭据或使用 Get-Credential 来输入登录凭据。
自动重新连接映射 启用在每次计算机启动时自动重新连接映射的选项 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Persistent $true 设置共享映射为持久连接，确保在计算机重启后自动重新连接。
指定域凭据 使用指定的域凭据进行映射 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Credential "DOMAIN\username" 使用域名、用户名进行凭据映射。
映射网络共享文件夹 映射一个共享文件夹并指定网络路径 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" 将远程共享文件夹映射到本地驱动器。
断开当前映射 可在映射前检查和断开已有的映射 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Force 使用 -Force 参数强制映射，即使该驱动器字母已被占用。
映射网络共享到驱动器字母 映射到指定驱动器字母，如 Z: 等 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" 映射到指定的本地驱动器字母。
不显示密码 映射时避免显示密码字段，提供隐私保护 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Credential (New-Object System.Management.Automation.PSCredential("username", (ConvertTo-SecureString "password" -AsPlainText -Force))) 提供加密形式的密码，避免在命令行中直接显示密码。
映射到指定的共享文件夹 映射到文件共享时指定网络驱动器路径 New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\folder\share" 映射到特定的共享文件夹路径，确保连接到正确的目录。

主要参数说明：

  • -LocalPath: 指定本地计算机上用于映射的驱动器字母（如："Z:"）。
  • -RemotePath: 指定要映射的共享文件夹的 UNC 路径（如："\\server\share"）。
  • -Credential: 指定用于连接到共享资源的凭据，通常通过 Get-Credential 来提供。
  • -Persistent: 设置映射是否在计算机重启后保持（如：$true 表示持久映射）。
  • -Force: 如果指定的驱动器字母已经被占用，强制重新映射。

示例：

  1. 将共享文件夹映射为驱动器 Z:

    powershellCopy Code
    New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share"

  2. 使用指定凭据将共享文件夹映射为驱动器 Z:

    powershellCopy Code
    New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Credential (Get-Credential)

  3. 将共享文件夹映射为驱动器 Z:，并设置为持久映射:

    powershellCopy Code
    New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Persistent $true

  4. 强制重新映射共享文件夹，覆盖现有映射:

    powershellCopy Code
    New-SmbMapping -LocalPath "Z:" -RemotePath "\\server\share" -Force

 

New-SmbMapping 是一个非常实用的 PowerShell cmdlet，用于映射网络共享路径。它支持多种功能，如凭据输入、持久化映射、强制覆盖等，帮助管理员灵活地管理网络共享资源。

New-SmbMapping命令在PowerShell中用于创建新的SMB映射，其主要参数如下：

  1. RemotePath：指定远程共享的路径。可以是网络共享的UNC路径，如\\server\share。

  2. LocalPath：指定本地计算机上的映射路径，通常是一个驱动器号或者文件夹路径。例如，Z: 或 C:\Share。

  3. Credential：用于连接远程共享的凭据对象。可以使用Get-Credential命令获取凭据对象，如 $cred = Get-Credential，然后将其作为参数传递给-Credential $cred。

  4. Scope：指定映射的作用范围。可以是当前会话 (Session) 或者是永久性的 (Persistent)。永久性映射将会在用户重新启动计算机后仍然存在。

  5. Description：可选参数，用于提供映射的描述信息。

  6. AccessMode：指定访问模式，可以是Read（只读）或ReadWrite（读写）。

  7. Force：可选参数，如果指定了这个参数，将会强制创建映射，即使目标路径已经存在其他映射。

  8. Confirm：在创建映射之前，确认操作。

  9. WhatIf：显示执行操作的结果，但不实际执行操作。

这些参数使得New-SmbMapping命令非常灵活，可以根据需要创建和管理SMB映射，方便用户在Windows环境中访问远程共享资源。

PowerShell中的New-SmbMapping命令用于在当前会话中创建一个新的 SMB 映射（SMB share）。这个命令通常用于在 PowerShell 脚本中或交互式会话中连接到远程共享文件夹或网络驱动器。以下是它的功能和作用：

  1. 连接到共享文件夹：

    • 可以使用New-SmbMapping命令连接到远程的 SMB 共享文件夹，这允许用户在本地文件系统中访问远程共享的文件和文件夹。

  2. 网络驱动器映射：

    • New-SmbMapping命令可以将远程共享映射为本地计算机上的网络驱动器。这样做可以方便用户在文件资源管理器或通过命令行访问共享内容，就像访问本地驱动器一样。

  3. 脚本和自动化：

    • 对于脚本和自动化任务，New-SmbMapping可以在脚本中使用，允许程序员和系统管理员动态地创建和管理共享映射，从而简化和自动化文件传输和访问任务。

  4. 参数设置：

    • 通过New-SmbMapping命令，可以指定远程共享的路径、本地驱动器的名称、凭据等选项，以确保连接的安全性和正确性。

示例用法如下：

powershellCopy Code
New-SmbMapping -RemotePath "\\server\share" -LocalPath "Z:" -Credential $cred

这条命令将远程的 \\server\share 共享映射为本地的 Z: 驱动器，使用提供的凭据（$cred）。这样，用户可以通过 Z: 驱动器访问远程共享的文件和文件夹。

 New-SmbMapping是一个强大的 PowerShell 命令，用于在 Windows 系统中管理和连接到 SMB 共享，适用于自动化任务和管理远程文件访问。

使用New-SmbMapping命令在PowerShell中创建一个新的SMB映射：

powershellCopy Code
# 获取远程共享的凭据
$cred = Get-Credential

# 创建新的SMB映射
New-SmbMapping -RemotePath "\\server\share" -LocalPath "Z:" -Credential $cred -Description "Remote Share Mapping"

# 确认映射是否成功创建
Get-SmbMapping

解释说明：

  1. Get-Credential命令用于获取远程共享的凭据。执行此命令后，会提示用户输入用户名和密码，并将其保存在变量 $cred 中。

  2. New-SmbMapping命令创建新的SMB映射。参数包括：

    • -RemotePath "\\server\share"：指定要映射的远程共享路径。
    • -LocalPath "Z:"：指定本地计算机上的映射路径，这里将远程共享映射为本地的 Z: 驱动器。
    • -Credential $cred：指定之前获取的远程共享的凭据。
    • -Description "Remote Share Mapping"：可选参数，提供了映射的描述信息。

  3. Get-SmbMapping命令用于确认映射是否成功创建。它会列出当前计算机上所有的SMB映射，包括我们刚刚创建的那个。

通过这个示例，你可以在PowerShell中实现远程共享文件夹到本地驱动器的映射，方便在命令行或文件资源管理器中访问远程文件。

使用PowerShell中的New-SmbMapping命令时，通常需要考虑以下步骤和参数：

  1. 获取凭据

    • 使用 Get-Credential 命令获取连接到远程共享所需的凭据。

  2. 创建新的SMB映射

    • 使用 New-SmbMapping 命令创建新的SMB映射。
    • 参数包括：
      • -RemotePath: 指定远程共享的路径，如 \\server\share。
      • -LocalPath: 指定本地计算机上的映射路径，例如 Z: 或 C:\Share。
      • -Credential: 指定用于连接远程共享的凭据对象。
      • -Description (可选): 提供映射的描述信息。
      • -Scope: 指定映射的作用范围，可以是当前会话 (Session) 或永久性 (Persistent)。
      • -AccessMode: 指定访问模式，可以是 Read（只读）或 ReadWrite（读写）。
      • -Force (可选): 如果指定了此参数，将强制创建映射，即使目标路径已存在其他映射。
      • -Confirm (可选): 在执行操作之前进行确认。
      • -WhatIf (可选): 显示执行操作的结果，但不实际执行操作。

  3. 确认映射是否创建成功

    • 使用 Get-SmbMapping 命令来验证新的SMB映射是否成功创建。

示例

以下是一个完整的示例，展示如何使用New-SmbMapping命令：

powershellCopy Code
# 获取远程共享的凭据
$cred = Get-Credential

# 创建新的SMB映射
New-SmbMapping -RemotePath "\\server\share" -LocalPath "Z:" -Credential $cred -Description "Remote Share Mapping"

# 确认映射是否成功创建
Get-SmbMapping

这个示例首先获取用户提供的远程共享凭据，然后使用这些凭据将远程共享路径 \\server\share 映射到本地计算机上的 Z: 驱动器，并提供了一个描述信息。最后，通过 Get-SmbMapping 命令确认新的SMB映射已经成功创建。

通过这些步骤，你可以在PowerShell中方便地管理和创建SMB映射，以便在本地计算机上访问远程共享的文件和文件夹。

 

posted @ 2024-08-01 15:00  suv789  阅读(420)  评论(0)    收藏  举报