Was this page helpful?
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

DriveCmdletProvider.NewDrive Method

Creates a new drive based on a specified PSDriveInfo object. Overriding this method gives the provider an opportunity to validate or modify the drive information before the drive is created.

Namespace: System.Management.Automation.Provider
Assembly: System.Management.Automation (in System.Management.Automation.dll)

Dim drive As PSDriveInfo
Dim returnValue As PSDriveInfo

returnValue = Me.NewDrive(drive)

protected virtual PSDriveInfo NewDrive (
	PSDriveInfo drive
protected PSDriveInfo NewDrive (
	PSDriveInfo drive
protected function NewDrive (
	drive : PSDriveInfo
) : PSDriveInfo



A PSDriveInfo object that describes the drive.

Return Value

A PSDriveInfo object that represents the new drive. The returned object can be the same object passed in by the drive parameter or a modified version of it. The default behavior is to return the passed-in PSDriveInfo object.

If an error occurs, an error record should be sent to the error pipeline using the WriteError method and null should be returned.

This method gives the provider an opportunity to associate provider-specific data with a drive. This is done by deriving a new class from the passed-in PSDriveInfo object and adding any properties, methods, or fields that are necessary.

To do this, the override of this method should first create an instance of a new derived PSDriveInfo class using the passed-in PSDriveInfo object and then return the derived PSDriveInfo object. (Note that the derived PSDriveInfo class should have a constructor that takes a PSDriveInfo object and that calls the PSDriveInfo private constructor.

Each subsequent call into the provider that uses this drive will then have access to the derived PSDriveInfo class via the PSDriveInfo property (which is provided by the base PSDriveInfo class).

For more information about providers, see Windows PowerShell Providers.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


Target Platforms

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft