PathIntrinsics.PopLocation(String) Method

Definition

Gets the location off the top of the location stack.

public:
 System::Management::Automation::PathInfo ^ PopLocation(System::String ^ stackName);
public System.Management.Automation.PathInfo PopLocation (string stackName);
member this.PopLocation : string -> System.Management.Automation.PathInfo
Public Function PopLocation (stackName As String) As PathInfo

Parameters

stackName
String

The ID of the stack to pop the location from. If stackName is null or empty the default stack is used.

Returns

The path information for the location that was on the top of the location stack.

Exceptions

If the path on the stack does not exist, is not a container, or resolved to multiple containers. or If stackName contains wildcard characters and resolves to multiple location stacks. or A stack was not found with the specified name.

If the path on the stack refers to a provider that does not exist.

If the path on the stack refers to a drive that does not exist.

If the provider associated with the path on the stack threw an exception.

Applies to