New-SmbMapping is a Windows PowerShell command that allows users to create a mapping between a local device and a remote server. This command is useful for creating a secure connection between two computers, allowing users to access files and other resources on the remote server. In this article, we will discuss the syntax, parameters, inputs, outputs, examples, and tips for using New-SmbMapping.
Syntax
The syntax for the New-SmbMapping command is as follows:
New-SmbMapping [-LocalPath] <String> [-RemotePath] <String> [-Credential] <PSCredential> [-Persistent] <SwitchParameter> [-Force] <SwitchParameter> [-WhatIf] <SwitchParameter> [-Confirm] <SwitchParameter>
Parameters
The parameters for the New-SmbMapping command are as follows:
| Parameter | Description |
|---|---|
| LocalPath | The local path to the remote server. |
| RemotePath | The remote path to the local device. |
| Credential | The credentials used to authenticate the connection. |
| Persistent | Specifies whether the mapping should be persistent or not. |
| Force | Specifies whether the mapping should be created even if it already exists. |
| WhatIf | Specifies whether the command should be run in a test mode. |
| Confirm | Specifies whether the user should be prompted for confirmation before running the command. |
Inputs
The inputs for the New-SmbMapping command are the local path, the remote path, the credentials, and the parameters. The local path is the path to the remote server, and the remote path is the path to the local device. The credentials are used to authenticate the connection, and the parameters are used to specify whether the mapping should be persistent, whether the mapping should be created even if it already exists, and whether the user should be prompted for confirmation before running the command.
Outputs
The output of the New-SmbMapping command is a mapping between the local device and the remote server. The mapping is created if the command is successful.
Examples
The following example creates a mapping between the local device and the remote server:
New-SmbMapping -LocalPath \\server\share -RemotePath C:\share -Credential domain\username -Persistent
The following example creates a mapping between the local device and the remote server, even if the mapping already exists:
New-SmbMapping -LocalPath \\server\share -RemotePath C:\share -Credential domain\username -Persistent -Force
Tips
When using the New-SmbMapping command, there are a few tips to keep in mind:
- Make sure that the local path and the remote path are correct.
- Make sure that the credentials are valid.
- Specify whether the mapping should be persistent or not.
- Specify whether the mapping should be created even if it already exists.
- Specify whether the user should be prompted for confirmation before running the command.
Conclusion
In conclusion, the New-SmbMapping command is a Windows PowerShell command that allows users to create a mapping between a local device and a remote server. This command is useful for creating a secure connection between two computers, allowing users to access files and other resources on the remote server. By following the syntax, parameters, inputs, outputs, examples, and tips outlined in this article, users can easily use the New-SmbMapping command to create a mapping between their local device and a remote server.