Paramètres dynamiques des applets de commande de fournisseur

Les fournisseurs peuvent définir des paramètres dynamiques qui sont ajoutés à une applet de commande de fournisseur lorsque l’utilisateur spécifie une certaine valeur pour l’un des paramètres statiques de l’applet de commande. Par exemple, un fournisseur peut ajouter des paramètres dynamiques différents en fonction du chemin d’accès que l’utilisateur spécifie lorsqu’il appelle les Get-Item applets de commande ou Set-Item .

Méthodes de paramètres dynamiques

Les paramètres dynamiques sont définis en implémentant l’une des méthodes de paramètre dynamique, telles que les méthodes System. Management. Automation. Provider. Itemcmdletprovider. Getitemdynamicparameters * et System. Management. Automation. Provider. Itemcmdletprovider. Setitemdynamicparameters *s. Ces méthodes retournent un objet dont les propriétés publiques sont décorées avec des attributs similaires à ceux des applets de commande autonomes. Voici un exemple d’implémentation de la méthode System. Management. Automation. Provider. Itemcmdletprovider. Getitemdynamicparameters * extraite du fournisseur de certificats :

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

Contrairement aux paramètres statiques des applets de commande du fournisseur, vous pouvez spécifier les caractéristiques de ces paramètres de la même façon que les paramètres sont définis dans des applets de commande autonomes. Voici un exemple de classe de paramètres dynamiques tirée du fournisseur de certificats :

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

Paramètres dynamiques

Voici une liste des paramètres statiques qui peuvent être utilisés pour ajouter des paramètres dynamiques.

Clear-Content Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l’applet de commande Clear-Clear en implémentant la méthode System. Management. Automation. Provider. Icontentcmdletprovider. Clearcontentdynamicparameters * .

Clear-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Clear-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Itemcmdletprovider. Clearitemdynamicparameters * .

Clear-ItemProperty Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Clear-ItemProperty applet de commande en implémentant la méthode System. Management. Automation. Provider. Ipropertycmdletprovider. Clearpropertydynamicparameters * .

Copy-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Destination paramètres, et Recurse de l’applet de commande Copy-Item en implémentant la méthode System. Management. Automation. Provider. Containercmdletprovider. Copyitemdynamicparameters * .

Get-ChildItems applet de commande vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Recurse paramètres et de l’applet de commande Get-ChildItem en implémentant les méthodes System. Management. Automation. Provider. Containercmdletprovider. Getchilditemsdynamicparameters * et System. Management. Automation. Provider. Containercmdletprovider. Getchildnamesdynamicparameters * .

Get-Content Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Get-Content applet de commande en implémentant la méthode System. Management. Automation. Provider. Icontentcmdletprovider. Getcontentreaderdynamicparameters * .

Get-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Get-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Itemcmdletprovider. Getitemdynamicparameters * .

Get-ItemProperty Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Name paramètres et de l' Get-ItemProperty applet de commande en implémentant la méthode System. Management. Automation. Provider. Ipropertycmdletprovider. Getpropertydynamicparameters * .

Invoke-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Invoke-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Itemcmdletprovider. Invokedefaultactiondynamicparameters * .

Move-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Destination paramètres et de l' Move-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Navigationcmdletprovider. Moveitemdynamicparameters * .

New-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path ItemType paramètres, et Value de l’applet de commande New-Item en implémentant la méthode System. Management. Automation. Provider. Containercmdletprovider. Newitemdynamicparameters * .

New-ItemProperty vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Name paramètres,, PropertyType et Value de l’applet de commande New-ItemProperty en implémentant la méthode System. Management. Automation. Provider. Idynamicpropertycmdletprovider. Newpropertydynamicparameters * .

New-PSDrive Vous pouvez définir des paramètres dynamiques qui sont déclenchés par l’objet System. Management. Automation. PSDriveinfo renvoyé par l' New-PSDrive applet de commande en implémentant la méthode System. Management. Automation. Provider. Drivecmdletprovider. Newdrivedynamicparameters * .

Remove-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par Path les Recurse paramètres et de l’applet de commande Remove-Item en implémentant la méthode System. Management. Automation. Provider. Containercmdletprovider. Removeitemdynamicparameters * .

Remove-ItemProperty Vous pouvez définir des paramètres dynamiques qui sont déclenchés par Path les Name paramètres et de l’applet de commande Remove-ItemProperty en implémentant la méthode System. Management. Automation. Provider. Idynamicpropertycmdletprovider. Removepropertydynamicparameters * .

Rename-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path NewName paramètres et de l' Rename-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Containercmdletprovider. Renameitemdynamicparameters * .

Rename-ItemProperty Vous pouvez définir des paramètres dynamiques qui sont déclenchés par Path les Name paramètres, et NewName de l' Rename-ItemProperty applet de commande en implémentant la méthode System. Management. Automation. Provider. Idynamicpropertycmdletprovider. Renamepropertydynamicparameters * .

Set-Content Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Set-Content applet de commande en implémentant la méthode System. Management. Automation. Provider. Icontentcmdletprovider. Getcontentwriterdynamicparameters * .

Set-Item Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Value paramètres et de l' Set-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Itemcmdletprovider. Setitemdynamicparameters * .

Set-ItemProperty Vous pouvez définir des paramètres dynamiques qui sont déclenchés par les Path Value paramètres et de l' Set-Item applet de commande en implémentant la méthode System. Management. Automation. Provider. Ipropertycmdletprovider. Setpropertydynamicparameters * .

Test-Path Vous pouvez définir des paramètres dynamiques qui sont déclenchés par le Path paramètre de l' Test-Path applet de commande en implémentant la méthode System. Management. Automation. Provider. Itemcmdletprovider. Invokedefaultactiondynamicparameters * .

Voir aussi

Écriture d’un fournisseur Windows PowerShell