PathIntrinsics.SetLocation(String) Method

Definition

Namespace:: System.Management.Automation

Assembly:: System.Management.Automation.dll

Package:: Microsoft.PowerShell.5.1.ReferenceAssemblies v1.0.0

Package:: System.Management.Automation v7.0.13

Package:: System.Management.Automation v7.1.7

Package:: System.Management.Automation v7.2.12

Package:: System.Management.Automation v7.3.5

Package:: System.Management.Automation v7.4.0

Package:: Microsoft.WSMan.Runtime v6.1.0

Package:: Microsoft.WSMan.Runtime v6.2.0

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Changes the current location to the specified path.

public:
 System::Management::Automation::PathInfo ^ SetLocation(System::String ^ path);

public System.Management.Automation.PathInfo SetLocation(string path);

member this.SetLocation : string -> System.Management.Automation.PathInfo

Public Function SetLocation (path As String) As PathInfo

Parameters

path: String

The path to change the location to. This can be either a drive-relative or provider-relative path. It cannot be a provider-internal path.

Returns

PathInfo

The path of the new current location.

Exceptions

ArgumentNullException

If path is null.

ArgumentException

If path does not exist, is not a container, or resolved to multiple containers.

ProviderNotFoundException

If path refers to a provider that does not exist.

DriveNotFoundException

If path refers to a drive that does not exist.

ProviderInvocationException

If the provider associated with path threw an exception.

Applies to