ChildItemCmdletProviderIntrinsics.Get Method

Definition

Namespace:

System.Management.Automation

Assembly:

System.Management.Automation.dll

Package:

System.Management.Automation v7.4.0

Overloads

Get(String, Boolean)	Gets the child items of the container at the given path.
Get(String[], Boolean, Boolean, Boolean)	Gets the child items of the container at the given path(s).
Get(String[], Boolean, UInt32, Boolean, Boolean)	Gets the child items of the container at the given path(s).

Get(String, Boolean)

Gets the child items of the container at the given path.

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ Get(System::String ^ path, bool recurse);

public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> Get (string path, bool recurse);

member this.Get : string * bool -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>

Public Function Get (path As String, recurse As Boolean) As Collection(Of PSObject)

Parameters

path

String

The path to the item to retrieve. It may be a drive or provider-qualified path and may include glob characters.

recurse

Boolean

If true, gets all the children in all the sub-containers of the specified container. If false, only gets the immediate children of the specified container.

Returns

Collection<PSObject>

The children of the container at the specified path. The type of the objects returned are determined by the provider that supports the given path.

Exceptions

ArgumentNullException

If path or context is null.

ProviderNotFoundException

If the path refers to a provider that could not be found.

DriveNotFoundException

If the path refers to a drive that could not be found.

ItemNotFoundException

If path does not contain glob characters and could not be found.

NotSupportedException

If the provider that the path refers to does not support this operation.

ProviderInvocationException

If the provider threw an exception.

Get(String[], Boolean, Boolean, Boolean)

Gets the child items of the container at the given path(s).

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ Get(cli::array <System::String ^> ^ path, bool recurse, bool force, bool literalPath);

public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> Get (string[] path, bool recurse, bool force, bool literalPath);

member this.Get : string[] * bool * bool * bool -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>

Public Function Get (path As String(), recurse As Boolean, force As Boolean, literalPath As Boolean) As Collection(Of PSObject)

Parameters

path

String[]

The path(s) to the item(s) to retrieve. They may be drive or provider-qualified paths and may include glob characters.

recurse

Boolean

If true, gets all the children in all the sub-containers of the specified container. If false, only gets the immediate children of the specified container.

force

Boolean

Passed on to providers to force operations.

literalPath

Boolean

If true, globbing is not done on paths.

Returns

Collection<PSObject>

The children of the container at the specified path. The type of the objects returned are determined by the provider that supports the given path.

Exceptions

ArgumentNullException

If path or context is null.

ProviderNotFoundException

If the path refers to a provider that could not be found.

DriveNotFoundException

If the path refers to a drive that could not be found.

ItemNotFoundException

If path does not contain glob characters and could not be found.

NotSupportedException

If the provider that the path refers to does not support this operation.

ProviderInvocationException

If the provider threw an exception.

Get(String[], Boolean, UInt32, Boolean, Boolean)

Gets the child items of the container at the given path(s).

public:
 System::Collections::ObjectModel::Collection<System::Management::Automation::PSObject ^> ^ Get(cli::array <System::String ^> ^ path, bool recurse, System::UInt32 depth, bool force, bool literalPath);

public System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject> Get (string[] path, bool recurse, uint depth, bool force, bool literalPath);

member this.Get : string[] * bool * uint32 * bool * bool -> System.Collections.ObjectModel.Collection<System.Management.Automation.PSObject>

Public Function Get (path As String(), recurse As Boolean, depth As UInteger, force As Boolean, literalPath As Boolean) As Collection(Of PSObject)

Parameters

path

String[]

The path(s) to the item(s) to retrieve. They may be drive or provider-qualified paths and may include glob characters.

recurse

Boolean

If true, gets all the children in all the sub-containers of the specified container. If false, only gets the immediate children of the specified container.

depth

UInt32

Limits the depth of recursion; uint.MaxValue performs full recursion.

force

Boolean

Passed on to providers to force operations.

literalPath

Boolean

If true, globbing is not done on paths.

Returns

Collection<PSObject>

The children of the container at the specified path. The type of the objects returned are determined by the provider that supports the given path.

Exceptions

ArgumentNullException

If path or context is null.

ProviderNotFoundException

If the path refers to a provider that could not be found.

DriveNotFoundException

If the path refers to a drive that could not be found.

ItemNotFoundException

If path does not contain glob characters and could not be found.

NotSupportedException

If the provider that the path refers to does not support this operation.

ProviderInvocationException

If the provider threw an exception.