DriveCmdletProvider.NewDrive(PSDriveInfo) Method

Reference

Definition

Namespace:: System.Management.Automation.Provider

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.

Gives the provider an opportunity to validate the drive that is being added. It also allows the provider to modify parts of the PSDriveInfo object. This may be done for performance or reliability reasons or to provide extra data to all calls using the Drive.

protected:
 virtual System::Management::Automation::PSDriveInfo ^ NewDrive(System::Management::Automation::PSDriveInfo ^ drive);

protected virtual System.Management.Automation.PSDriveInfo NewDrive (System.Management.Automation.PSDriveInfo drive);

abstract member NewDrive : System.Management.Automation.PSDriveInfo -> System.Management.Automation.PSDriveInfo
override this.NewDrive : System.Management.Automation.PSDriveInfo -> System.Management.Automation.PSDriveInfo

Protected Overridable Function NewDrive (drive As PSDriveInfo) As PSDriveInfo

Parameters

drive: PSDriveInfo

The proposed new drive.

Returns

PSDriveInfo

The new drive that is to be added to the MSH namespace. This can either be the same drive object that was passed in or a modified version of it.

The default implementation returns the drive that was passed.

Remarks

This method gives the provider an opportunity to associate provider specific data with a drive. This is done by deriving a new class from PSDriveInfo and adding any properties, methods, or fields that are necessary. When this method gets called, the override should create an instance of the derived PSDriveInfo using the passed in PSDriveInfo. The derived PSDriveInfo should then be returned. Each subsequent call into the provider that uses this drive will have access to the derived PSDriveInfo via the PSDriveInfo property provided by the base class.

Any failures should be sent to the WriteError(ErrorRecord) method and null should be returned.

Applies to