Parámetros dinámicos del cmdlet de proveedor

Los proveedores pueden definir parámetros dinámicos que se agregan a un cmdlet de proveedor cuando el usuario especifica un valor determinado para uno de los parámetros estáticos del cmdlet. Por ejemplo, un proveedor puede agregar parámetros dinámicos diferentes en función de la ruta de acceso que especifica el usuario cuando llama a los cmdlets de proveedor Get-Item o Set-Item.

Métodos de parámetro dinámico

Los parámetros dinámicos se definen mediante la implementación de uno de los métodos de parámetro dinámico, como los métodos System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters* y System.Management.Automation.Provider.SetItemDynamicParameters.SetItemDynamicParameters*. Estos métodos devuelven un objeto que tiene propiedades públicas decoradas con atributos similares a los de cmdlets independientes. Este es un ejemplo de una implementación del método System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters* tomado del proveedor de certificados:

protected override object GetItemDynamicParameters(string path)
{
    return new CertificateProviderDynamicParameters();
}

A diferencia de los parámetros estáticos de los cmdlets de proveedor, puede especificar las características de estos parámetros de la misma manera que los parámetros se definen en cmdlets independientes. Este es un ejemplo de una clase de parámetro dinámico tomada del proveedor de certificados:

internal sealed class CertificateProviderDynamicParameters
{
  /// <summary>
  /// Dynamic parameter the controls whether we only return
  /// code signing certs.
  /// </summary>
  [Parameter()]
  public SwitchParameter CodeSigningCert
  {
    get
    {
      {
        return codeSigningCert;
      }
    }

    set
    {
      {
        codeSigningCert = value;
      }
    }
  }

    private SwitchParameter codeSigningCert = new SwitchParameter();
}

Parámetros dinámicos

Esta es una lista de los parámetros estáticos que se pueden usar para agregar parámetros dinámicos.

• cmdlet Clear-Content: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Clear-Clear implementando el método System.Management.Automation.Provider.IContentCmdletProvider.ClearContentDynamicParameters*.

• cmdlet Clear-Item: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Clear-Item mediante la implementación del método System.Management.Automation.Provider.ItemCmdletProvider.ClearItemDynamicParameters*.

• cmdlet Clear-ItemProperty: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Clear-ItemProperty mediante la implementación del método System.Management.Automation.Provider.IPropertyCmdletProvider.ClearPropertyDynamicParameters*.

• cmdlet Copy-Item: puede definir parámetros dinámicos desencadenados por los parámetros Path, Destinationy Recurse del cmdlet Copy-Item mediante la implementación del método System.Management.Automation.Provider.ContainerCmdletProvider.CopyItemDynamicParameters*.

• cmdlet Get-ChildItem: puede definir parámetros dinámicos desencadenados por los parámetros Path y Recurse del cmdlet Get-ChildItem implementando los métodos System.Management.Automation.Provider.ContainerCmdletProvider.GetChildItemsDynamicParameters* y System.Management.Automation.Provider.ContainerCmdletProvider.GetChildNamesDynamicParameters*.

• cmdlet Get-Content: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Get-Content implementando el método System.Management.Automation.Provider.IContentCmdletProvider.GetContentReaderDynamicParameters*.

• cmdlet Get-Item: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Get-Item implementando el método System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters*.

• cmdlet Get-ItemProperty: puede definir parámetros dinámicos desencadenados por los parámetros Path y Name del cmdlet Get-ItemProperty implementando el método System.Management.Automation.Provider.IPropertyCmdletProvider.GetPropertyDynamicParameters*.

• cmdlet Invoke-Item: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Invoke-Item mediante la implementación del método System.Management.Automation.Provider.ItemCmdletProvider.InvokeDefaultActionDynamicParameters*.

• cmdlet Move-Item: puede definir parámetros dinámicos desencadenados por los parámetros Path y Destination del cmdlet Move-Item mediante la implementación del método System.Management.Automation.Provider.NavigationCmdletProvider.MoveItemDynamicParameters*.

• cmdlet New-Item: puede definir parámetros dinámicos desencadenados por los parámetros Path, ItemTypey Value del cmdlet New-Item mediante la implementación del método System.Management.Automation.Provider.ContainerCmdletProvider.NewItemDynamicParameters*.

• cmdlet New-ItemProperty: puede definir parámetros dinámicos desencadenados por los parámetros Path, Name, PropertyTypey Value del cmdlet New-ItemProperty mediante la implementación del método System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.NewPropertyDynamicParameters*.

• cmdlet New-PSDrive: puede definir parámetros dinámicos desencadenados por el objeto System.Management.Automation.PSDriveInfo devuelto por el cmdlet New-PSDrive mediante la implementación del método System.Management.Automation.Provider.DriveCmdletProvider.NewDriveDynamicParameters*.

• cmdlet Remove-Item: puede definir parámetros dinámicos desencadenados por los parámetros Path y Recurse del cmdlet Remove-Item implementando el método System.Management.Automation.Provider.ContainerCmdletProvider.RemoveItemDynamicParameters*.

• cmdlet Remove-ItemProperty: puede definir parámetros dinámicos desencadenados por los parámetros Path y Name del cmdlet Remove-ItemProperty implementando el método System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.RemovePropertyDynamicParameters*.

• cmdlet Rename-Item: puede definir parámetros dinámicos desencadenados por los parámetros Path y NewName del cmdlet Rename-Item mediante la implementación del método System.Management.Automation.Provider.ContainerCmdletProvider.RenameItemDynamicParameters*.

• Rename-ItemProperty: puede definir parámetros dinámicos desencadenados por los parámetros Path, Namey NewName del cmdlet Rename-ItemProperty mediante la implementación del método System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.RenamePropertyDynamicParameters*.

• cmdlet Set-Content: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Set-Content implementando el método System.Management.Automation.Provider.IContentCmdletProvider.GetContentWriterDynamicParameters*.

• cmdlet Set-Item: puede definir parámetros dinámicos desencadenados por los parámetros Path y Value del cmdlet Set-Item implementando el método System.Management.Automation.Provider.ItemCmdletProvider.SetItemDynamicParameters*.

• cmdlet Set-ItemProperty: puede definir parámetros dinámicos desencadenados por los parámetros Path y Value del cmdlet Set-Item implementando el método System.Management.Automation.Provider.IPropertyCmdletProvider.SetPropertyDynamicParameters*.

• cmdlet Test-Path: puede definir parámetros dinámicos desencadenados por el parámetro Path del cmdlet Test-Path mediante la implementación del método System.Management.Automation.Provider.ItemCmdletProvider.InvokeDefaultActionDynamicParameters*.

Véase también

escribir un proveedor de Windows PowerShell