Dynamiska cmdlet-parametrar för providers

Leverantörer kan definiera dynamiska parametrar som läggs till i en provider-cmdlet när användaren anger ett visst värde för en av cmdletens statiska parametrar. En provider kan till exempel lägga till olika dynamiska parametrar baserat på vilken sökväg användaren anger när de anropar cmdletarna Get-Item eller Set-Item provider.

Metoder för dynamisk parameter

Dynamiska parametrar definieras genom att implementera någon av de dynamiska parametermetoderna, till exempel System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters* och System.Management.Automation.Provider.SetItemDynamicParameters.SetItemDynamicParameters* metoder. Dessa metoder returnerar ett objekt som har offentliga egenskaper som är dekorerade med attribut som liknar dem för fristående cmdletar. Här är ett exempel på en implementering av System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters* metod från certifikatprovidern:

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

Till skillnad från de statiska parametrarna för provider-cmdletar kan du ange egenskaperna för dessa parametrar på samma sätt som parametrar definieras i fristående cmdletar. Här är ett exempel på en dynamisk parameterklass som hämtats från certifikatprovidern:

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();
}

Dynamiska parametrar

Här är en lista över de statiska parametrar som kan användas för att lägga till dynamiska parametrar.

• Clear-Content cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Clear-Clear genom att implementera metoden System.Management.Automation.Provider.IContentCmdletProvider.ClearContentDynamicParameters*.

• Clear-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Clear-Item genom att implementera System.Management.Automation.Provider.ItemCmdletProvider.ClearItemDynamicParameters*-metoden.

• Clear-ItemProperty cmdlet – Du kan definiera dynamiska parametrar som utlöses av Path-parametern i cmdleten Clear-ItemProperty genom att implementera metoden System.Management.Automation.Provider.IPropertyCmdletProvider.ClearPropertyDynamicParameters*.

• Copy-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path, Destinationoch Recurse för cmdleten Copy-Item genom att implementera metoden System.Management.Automation.Provider.ContainerCmdletProvider.CopyItemDynamicParameters*.

• Get-ChildItem cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Recurse för cmdleten Get-ChildItem genom att implementera System.Management.Automation.Provider.ContainerCmdletProvider.GetChildItemsDynamicParameters* och System.Management.Automation.Provider.ContainerCmdletProvider.GetChildNamesDynamicParameters* metoder.

• Get-Content cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Get-Content genom att implementera System.Management.Automation.Provider.IContentCmdletProvider.GetContentReaderDynamicParameters*-metoden.

• Get-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Get-Item genom att implementera metoden System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters*.

• Get-ItemProperty cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Name för cmdleten Get-ItemProperty genom att implementera metoden System.Management.Automation.Provider.IPropertyCmdletProvider.GetPropertyDynamicParameters*.

• Invoke-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Invoke-Item genom att implementera metoden System.Management.Automation.Provider.ItemCmdletProvider.InvokeDefaultActionDynamicParameters*.

• Move-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Destination för cmdleten Move-Item genom att implementera metoden System.Management.Automation.Provider.NavigationCmdletProvider.MoveItemDynamicParameters*.

• New-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path, ItemTypeoch Value för cmdleten New-Item genom att implementera metoden System.Management.Automation.Provider.ContainerCmdletProvider.NewItemDynamicParameters*.

• New-ItemProperty cmdlet – Du kan definiera dynamiska parametrar som utlöses av cmdleten Path, Name, PropertyTypeoch Value parametrar för cmdleten New-ItemProperty genom att implementera System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.NewPropertyDynamicParameters*-metoden.

• New-PSDrive cmdlet – Du kan definiera dynamiska parametrar som utlöses av objektet System.Management.Automation.PSDriveInfo som returneras av cmdleten New-PSDrive genom att implementera metoden System.Management.Automation.Provider.DriveCmdletProvider.NewDriveDynamicParameters*.

• Remove-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Recurse i cmdleten Remove-Item genom att implementera metoden System.Management.Automation.Provider.ContainerCmdletProvider.RemoveItemDynamicParameters*.

• Remove-ItemProperty cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Name för cmdleten Remove-ItemProperty genom att implementera System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.RemovePropertyDynamicParameters*-metoden.

• Rename-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och NewName för cmdleten Rename-Item genom att implementera metoden System.Management.Automation.Provider.ContainerCmdletProvider.RenameItemDynamicParameters*.

• Rename-ItemProperty – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path, Nameoch NewName för cmdleten Rename-ItemProperty genom att implementera System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.RenamePropertyDynamicParameters*-metoden.

• Set-Content cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Set-Content genom att implementera System.Management.Automation.Provider.IContentCmdletProvider.GetContentWriterDynamicParameters*-metoden.

• Set-Item cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Value för cmdleten Set-Item genom att implementera metoden System.Management.Automation.Provider.ItemCmdletProvider.SetItemDynamicParameters*.

• Set-ItemProperty cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametrarna Path och Value för cmdleten Set-Item genom att implementera System.Management.Automation.Provider.IPropertyCmdletProvider.SetPropertyDynamicParameters*-metoden.

• Test-Path cmdlet – Du kan definiera dynamiska parametrar som utlöses av parametern Path för cmdleten Test-Path genom att implementera metoden System.Management.Automation.Provider.ItemCmdletProvider.InvokeDefaultActionDynamicParameters*.

Se även

Skriva en Windows PowerShell-provider