提供商类型

提供程序通过更改 PowerShell 提供的提供程序 cmdlet 执行其操作的方式来定义其基本功能。例如，提供程序可以使用 Get-Item cmdlet 的默认功能，或者可以更改该 cmdlet 在从数据存储中检索项目时的操作方式。本文档中描述的提供程序功能包括通过覆盖特定提供程序基类和接口的方法来定义的功能。

笔记

有关 PowerShell 预定义的提供程序功能，请参阅提供程序功能。

支持驱动器的提供商

支持驱动器的提供程序指定用户可用的默认驱动器，并允许用户添加或删除驱动器。在大多数情况下，提供程序是启用驱动器的提供程序，因为它们需要某些默认驱动器才能访问数据存储。但是，在编写自己的提供程序时，您可能希望也可能不希望允许用户创建和删除驱动器。

要创建启用驱动器的提供程序，您的提供程序类必须从 System.Management.Automation.Provider.DriveCmdletProvider 类或从该类派生的另一个类派生。 DriveCmdletProvider 类定义了以下方法，用于实现提供程序的默认驱动器并支持 New-PSDrive 和 Remove-PSDrive cmdlet。在大多数情况下，要支持提供程序 cmdlet，您必须覆盖 PowerShell 引擎调用来调用 cmdlet 的方法，例如 New-PSDrive cmdlet 的 NewDrive 方法，您还可以选择覆盖第二个方法，例如 NewDriveDynamicParameters，用于向 cmdlet 添加动态参数。

• InitializeDefaultDrives 方法定义每当使用提供程序时用户可用的默认驱动器。

• NewDrive 和 NewDriveDynamicParameters 方法定义您的提供程序如何支持 New-PSDrive 提供程序 cmdlet。此 cmdlet 允许用户创建驱动器来访问数据存储。

• RemoveDrive 方法定义您的提供程序如何支持 Remove-PSDrive 提供程序 cmdlet。此 cmdlet 允许用户从数据存储中删除驱动器。

支持项目的提供商

支持项目的提供程序允许用户获取、设置或清除数据存储中的项目。 “项目”是用户可以独立访问或管理的数据存储的元素。要创建启用项目的提供程序，您的提供程序类必须从 System.Management.Automation.Provider.ItemCmdletProvider 类或从该类派生的另一个类派生。

ItemCmdletProvider 类定义了以下用于实现特定提供程序 cmdlet 的方法。在大多数情况下，要支持提供程序 cmdlet，您必须覆盖 PowerShell 引擎调用来调用 cmdlet 的方法，例如 Clear-Item cmdlet 的 ClearItem 方法，您还可以选择覆盖第二个方法，例如 ClearItemDynamicParameters，用于向 cmdlet 添加动态参数。

• ClearItem 和 ClearItemDynamicParameters 方法定义您的提供程序如何支持 Clear-Item 提供程序 cmdlet。此 cmdlet 允许用户删除数据存储中项目的值。

• GetItem 和 GetItemDynamicParameters 方法定义您的提供程序如何支持 Get-Item 提供程序 cmdlet。此 cmdlet 允许用户从数据存储中检索数据。

• SetItem 和 SetItemDynamicParameters 方法定义您的提供程序如何支持 Set-Item 提供程序 cmdlet。此 cmdlet 允许用户更新数据存储中的项目值。

• InvokeDefaultAction 和 InvokeDefaultActionDynamicParameters 方法定义您的提供程序如何支持 Invoke-Item 提供程序 cmdlet。此 cmdlet 允许用户执行该项目指定的默认操作。

• ItemExists 和 ItemExistsDynamicParameters 方法定义您的提供程序如何支持 Test-Path 提供程序 cmdlet。此 cmdlet 允许用户确定路径的所有元素是否存在。

除了用于实现提供程序 cmdlet 的方法之外，ItemCmdletProvider 类还定义了以下方法：

• ExpandPath 方法允许用户在指定提供程序路径时使用通配符。

• IsValidPath 用于确定路径在语法和语义上对于提供者是否有效。

支持容器的提供商

支持容器的提供程序允许用户管理容器项目。容器是同一父项下的一组子项。要创建支持容器的提供程序，您的提供程序类必须从 System.Management.Automation.Provider.ContainerCmdletProvider 类或从该类派生的另一个类派生。

这很重要

支持容器的提供程序无法访问包含嵌套容器的数据存储。如果容器的子项是另一个容器，则必须实现支持导航的提供程序。

ContainerCmdletProvider 类定义了以下方法来实现特定的提供程序 cmdlet。在大多数情况下，要支持提供程序 cmdlet，您必须覆盖 PowerShell 引擎调用来调用 cmdlet 的方法，例如 Copy-Item cmdlet 的 CopyItem 方法，您还可以选择覆盖第二个方法，例如 CopyItemDynamicParameters，用于向 cmdlet 添加动态参数。

• CopyItem 和 CopyItemDynamicParameters 方法定义您的提供程序如何支持 Copy-Item 提供程序 cmdlet。此 cmdlet 允许用户将项目从一个位置复制到另一个位置。

• GetChildItems 和 GetChildItemsDynamicParameters 方法定义您的提供程序如何支持 Get-ChildItem 提供程序 cmdlet。此 cmdlet 允许用户检索父项的子项。

• GetChildNames 和 GetChildNamesDynamicParameters 方法定义您的提供程序如何支持 Get-ChildItem 提供程序 cmdlet（如果指定了 Name 参数）。

• NewItem 和 NewItemDynamicParameters 方法定义您的提供程序如何支持 New-Item 提供程序 cmdlet。此 cmdlet 允许用户在数据存储中创建新项目。

• RemoveItem 和RemoveItemDynamicParameters 方法定义您的提供程序如何支持Remove-Item 提供程序cmdlet。此 cmdlet 允许用户从数据存储中删除项目。

• RenameItem 和 RenameItemDynamicParameters 方法定义您的提供程序如何支持 Rename-Item 提供程序 cmdlet。此 cmdlet 允许用户重命名数据存储中的项目。

除了用于实现提供程序 cmdlet 的方法之外，ContainerCmdletProvider 类还定义了以下方法：

• 提供程序类可以使用 HasChildItems 方法来确定项目是否具有子项目。

• 提供程序类可以使用 ConvertPath 方法从指定路径创建新的特定于提供程序的路径。

支持导航的提供商

支持导航的提供程序允许用户移动数据存储中的项目。要创建支持导航的提供程序，提供程序类必须派生自 System.Management.Automation.Provider.NavigationCmdletProvider 类。

NavigationCmdletProvider 类定义了以下用于实现特定提供程序 cmdlet 的方法。在大多数情况下，要支持提供程序 cmdlet，您必须覆盖 PowerShell 引擎调用来调用 cmdlet 的方法，例如 Move-Item cmdlet 的 MoveItem 方法，您还可以选择覆盖第二个方法，例如 MoveItemDynamicParameters，用于向 cmdlet 添加动态参数。

• MoveItem 和 MoveItemDynamicParameters 方法定义您的提供程序如何支持 Move-Item 提供程序 cmdlet。此 cmdlet 允许用户将商品从商店中的一个位置移动到另一个位置。

• MakePath 方法定义您的提供程序如何支持 Join-Path 提供程序 cmdlet。此 cmdlet 允许用户组合父路径段和子路径段以创建提供程序内部路径。

除了用于实现提供程序 cmdlet 的方法之外，NavigationCmdletProvider 类还定义了以下方法：

• GetChildName 方法提取路径的子节点的名称。

• GetParentPath 方法提取路径的父部分。

• IsItemContainer 方法确定该项目是否是容器项目。在此上下文中，容器是公共父项下的一组子项。

• NormalizeRelativePath 方法返回相对于指定基本路径的项目的路径。

内容支持的提供商

支持内容的提供程序允许用户清除、获取或设置数据存储中的项目内容。例如，FileSystem 提供程序允许您清除、获取和设置文件系统中的文件内容。要创建启用内容的提供程序，提供程序类必须实现 System.Management.Automation.Provider.IContentCmdletProvider 接口的方法。

IContentCmdletProvider 接口定义了以下用于实现特定提供程序 cmdlet 的方法。在大多数情况下，要支持提供程序 cmdlet，您必须覆盖 PowerShell 引擎调用来调用 cmdlet 的方法，例如 Clear-Content cmdlet 的 ClearContent 方法，您还可以选择覆盖第二个方法，例如 ClearContentDynamicParameters，用于向 cmdlet 添加动态参数。

• ClearContent 和 ClearContentDynamicParameters 方法定义您的提供程序如何支持 Clear-Content 提供程序 cmdlet。此 cmdlet 允许用户删除项目的内容而不删除该项目。

• GetContentReader 和 GetContentReaderDynamicParameters 方法定义您的提供程序如何支持 Get-Content 提供程序 cmdlet。此 cmdlet 允许用户检索项目的内容。 GetContentReader 方法返回一个 System.Management.Automation.Provider.IContentReader 接口，该接口定义用于读取内容的方法。

• GetContentWriter 和 GetContentWriterDynamicParameters 方法定义您的提供程序如何支持 Set-Content 提供程序 cmdlet。此 cmdlet 允许用户更新项目的内容。 GetContentWriter 方法返回一个 System.Management.Automation.Provider.IContentWriter 接口，该接口定义用于写入内容的方法。

财产支持的提供商

支持属性的提供程序允许用户管理数据存储中项目的属性。要创建启用属性的提供程序，提供程序类必须实现 System.Management.Automation.Provider.IPropertyCmdletProvider 和 System.Management.Automation.Provider.IDynamicPropertyCmdletProvider 接口的方法。在大多数情况下，要支持提供程序 cmdlet，您必须覆盖 PowerShell 引擎调用来调用 cmdlet 的方法，例如 Clear-Property cmdlet 的 ClearProperty 方法，并且您可以选择覆盖第二个方法方法，例如 ClearPropertyDynamicParameters，用于向 cmdlet 添加动态参数。

IPropertyCmdletProvider 接口定义了以下用于实现特定提供程序 cmdlet 的方法：

• ClearProperty 和 ClearPropertyDynamicParameters 方法定义您的提供程序如何支持 Clear-ItemProperty 提供程序 cmdlet。此 cmdlet 允许用户删除属性的值。

• GetProperty 和 GetPropertyDynamicParameters 方法定义您的提供程序如何支持 Get-ItemProperty 提供程序 cmdlet。此 cmdlet 允许用户检索项目的属性。

• SetProperty 和 SetPropertyDynamicParameters 方法定义您的提供程序如何支持 Set-ItemProperty 提供程序 cmdlet。此 cmdlet 允许用户更新项目的属性。

IDynamicPropertyCmdletProvider 接口定义了以下用于实现特定提供程序 cmdlet 的方法：

• CopyProperty 和 CopyPropertyDynamicParameters 方法定义您的提供程序如何支持 Copy-ItemProperty 提供程序 cmdlet。此 cmdlet 允许用户将属性及其值从一个位置复制到另一个位置。

• MoveProperty 和 MovePropertyDynamicParameters 方法定义您的提供程序如何支持 Move-ItemProperty 提供程序 cmdlet。此 cmdlet 允许用户将属性及其值从一个位置移动到另一个位置。

• NewProperty 和 NewPropertyDynamicParameters 方法定义您的提供程序如何支持 New-ItemProperty 提供程序 cmdlet。此 cmdlet 允许用户创建新属性并设置其值。

• RemoveProperty 和RemovePropertyDynamicParameters 方法定义您的提供程序如何支持Remove-ItemProperty cmdlet。此 cmdlet 允许用户删除属性及其值。

• RenameProperty 和 RenamePropertyDynamicParameters 方法定义您的提供程序如何支持 Rename-ItemProperty cmdlet。此 cmdlet 允许用户更改属性的名称。

参见

about_Providers

编写 Windows PowerShell 提供程序