Dynamische Anbieter-Cmdlet-Parameter

Anbieter können dynamische Parameter definieren, die einem Anbieter-Cmdlet hinzugefügt werden, wenn der Benutzer einen bestimmten Wert für einen der statischen Parameter des Cmdlets angibt. Beispielsweise kann ein Anbieter unterschiedliche dynamische Parameter hinzufügen, basierend auf dem Pfad, den der Benutzer angibt, wenn er die cmdlets Get-Item oder Set-Item Anbieter aufruft.

Dynamische Parametermethoden

Dynamische Parameter werden durch Implementieren einer der dynamischen Parametermethoden definiert, z. B. System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters* und System.Management.Automation.Provider.SetItemDynamicParameters.SetItemDynamicParameters* Methoden. Diese Methoden geben ein Objekt zurück, das öffentliche Eigenschaften aufweist, die mit Attributen versehen sind, die denen von eigenständigen Cmdlets ähneln. Nachfolgend finden Sie ein Beispiel für eine Implementierung der System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters* Methode, die vom Zertifikatanbieter stammt:

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

Im Gegensatz zu den statischen Parametern von Anbieter-Cmdlets können Sie die Merkmale dieser Parameter auf die gleiche Weise angeben, wie Parameter in eigenständigen Cmdlets definiert werden. Nachfolgend sehen Sie ein Beispiel für eine dynamische Parameterklasse, die vom Zertifikatanbieter stammt:

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

Dynamische Parameter

Hier ist eine Liste der statischen Parameter, die zum Hinzufügen dynamischer Parameter verwendet werden können.

• Clear-Content Cmdlet – Sie können dynamische Parameter definieren, die durch den Path Parameter des cmdlets Clear-Clear ausgelöst werden, indem Sie die System.Management.Automation.Provider.IContentCmdletProvider.ClearContentDynamicParameters* Methode implementieren.

• Clear-Item Cmdlet – Sie können dynamische Parameter definieren, die durch den parameter Path des Cmdlets Clear-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.ItemCmdletProvider.ClearItemDynamicParameters* Methode implementieren.

• Clear-ItemProperty Cmdlet – Sie können dynamische Parameter definieren, die durch den Path Parameter des cmdlets Clear-ItemProperty ausgelöst werden, indem Sie die System.Management.Automation.Provider.IPropertyCmdletProvider.ClearPropertyDynamicParameters* Methode implementieren.

• Copy-Item Cmdlet – Sie können dynamische Parameter definieren, die durch die Path, Destinationund Recurse Parameter des Cmdlets Copy-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.ContainerCmdletProvider.CopyItemDynamicParameters*-Methode implementieren.

• Get-ChildItem Cmdlet – Sie können dynamische Parameter definieren, die durch die Parameter Path und Recurse des Get-ChildItem Cmdlets ausgelöst werden, indem Sie die System.Management.Automation.Provider.ContainerCmdletProvider.GetChildItemsDynamicParameters* und System.Management.Automation.Provider.ContainerCmdletProvider.GetChildNamesDynamicParameters* Methoden implementieren.

• Get-Content Cmdlet – Sie können dynamische Parameter definieren, die durch den parameter Path des Cmdlets Get-Content ausgelöst werden, indem Sie die System.Management.Automation.Provider.IContentCmdletProvider.GetContentReaderDynamicParameters* Methode implementieren.

• Get-Item Cmdlet – Sie können dynamische Parameter definieren, die durch den Path Parameter des cmdlets Get-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.ItemCmdletProvider.GetItemDynamicParameters*-Methode implementieren.

• Get-ItemProperty Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path und Name des Cmdlets Get-ItemProperty ausgelöst werden, indem Sie die System.Management.Automation.Provider.IPropertyCmdletProvider.GetPropertyDynamicParameters*-Methode implementieren.

• Invoke-Item Cmdlet – Sie können dynamische Parameter definieren, die durch den Path-Parameter des cmdlets Invoke-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.ItemCmdletProvider.InvokeDefaultActionDynamicParameters* Methode implementieren.

• Move-Item Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path und Destination des Cmdlets Move-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.NavigationCmdletProvider.MoveItemDynamicParameters* Methode implementieren.

• New-Item Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path, ItemTypeund Value des Cmdlets New-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.ContainerCmdletProvider.NewItemDynamicParameters*-Methode implementieren.

• New-ItemProperty Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path, Name, PropertyTypeund Value des Cmdlets New-ItemProperty ausgelöst werden, indem Sie die System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.NewPropertyDynamicParameters*-Methode implementieren.

• New-PSDrive Cmdlet – Sie können dynamische Parameter definieren, die durch das System.Management.Automation.PSDriveInfo objekt ausgelöst werden, das vom cmdlet New-PSDrive zurückgegeben wird, indem Sie die System.Management.Automation.Provider.DriveCmdletProvider.NewDriveDynamicParameters* Methode implementieren.

• Remove-Item Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path und Recurse des Remove-Item Cmdlets ausgelöst werden, indem Sie die System.Management.Automation.Provider.ContainerCmdletProvider.RemoveItemDynamicParameters* Methode implementieren.

• Remove-ItemProperty Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path und Name des Cmdlets Remove-ItemProperty ausgelöst werden, indem Sie die System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.RemovePropertyDynamicParameters*-Methode implementieren.

• Rename-Item Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path und NewName des Cmdlets Rename-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.ContainerCmdletProvider.RenameItemDynamicParameters* Methode implementieren.

• Rename-ItemProperty – Sie können dynamische Parameter definieren, die durch die Parameter Path, Nameund NewName des Cmdlets Rename-ItemProperty ausgelöst werden, indem Sie die System.Management.Automation.Provider.IDynamicPropertyCmdletProvider.RenamePropertyDynamicParameters*-Methode implementieren.

• Set-Content Cmdlet – Sie können dynamische Parameter definieren, die durch den Path Parameter des cmdlets Set-Content ausgelöst werden, indem Sie die System.Management.Automation.Provider.IContentCmdletProvider.GetContentWriterDynamicParameters* Methode implementieren.

• Set-Item Cmdlet – Sie können dynamische Parameter definieren, die durch die parameter Path und Value des Set-Item Cmdlets ausgelöst werden, indem Sie die System.Management.Automation.Provider.ItemCmdletProvider.SetItemDynamicParameters* Methode implementieren.

• Set-ItemProperty Cmdlet – Sie können dynamische Parameter definieren, die durch die Path und Value Parameter des Cmdlets Set-Item ausgelöst werden, indem Sie die System.Management.Automation.Provider.IPropertyCmdletProvider.SetPropertyDynamicParameters* Methode implementieren.

• Test-Path Cmdlet – Sie können dynamische Parameter definieren, die durch den Path-Parameter des cmdlets Test-Path ausgelöst werden, indem Sie die System.Management.Automation.Provider.ItemCmdletProvider.InvokeDefaultActionDynamicParameters* Methode implementieren.

Siehe auch

Schreiben eines Windows PowerShell-Anbieters