PathIntrinsics.PopLocation(String) Method

Reference

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.

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

PathInfo

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

Exceptions

ArgumentException

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.

ProviderNotFoundException

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

DriveNotFoundException

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

ProviderInvocationException

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

Applies to