Typy dostawców
Dostawcy definiują swoje podstawowe funkcje, zmieniając sposób wykonywania akcji przez polecenia cmdlet dostawcy dostarczane przez program PowerShell. Na przykład dostawcy mogą używać domyślnej funkcjonalności polecenia cmdlet lub mogą zmieniać sposób działania tego polecenia cmdlet podczas pobierania elementów Get-Item
z magazynu danych. Funkcje dostawcy opisane w tym dokumencie obejmują funkcje zdefiniowane przez metody nadpisywania z określonych klas bazowych i interfejsów dostawcy.
Uwaga
Aby uzyskać informacje o funkcjach dostawcy wstępnie zdefiniowanych przez program PowerShell, zobacz Możliwości dostawcy.
Dostawcy z włączoną obsługą dysków
Dostawcy z włączoną obsługą dysków określają domyślne dyski dostępne dla użytkownika i zezwalają użytkownikowi na dodawanie lub usuwanie dysków. W większości przypadków dostawcy są dostawcami z włączoną obsługą dysków, ponieważ wymagają dysku domyślnego, aby uzyskać dostęp do magazynu danych. Jednak podczas pisania własnego dostawcy możesz zezwolić użytkownikowi na tworzenie i usuwanie dysków.
Aby utworzyć dostawcę z włączoną obsługą dysków, klasa dostawcy musi pochodzić z klasy System.Management.Automation.Provider.DriveCmdletProvider lub innej klasy pochodzącej od tej klasy. Klasa DriveCmdletProvider definiuje następujące metody implementowania dysków domyślnych dostawcy i obsługi New-PSDrive
polecenia Remove-PSDrive
cmdlet i . W większości przypadków w celu obsługi polecenia cmdlet dostawcy należy zastąpić metodę wywoływaną przez aparat programu PowerShell w celu wywołania polecenia cmdlet, taką jak metoda polecenia cmdlet, i opcjonalnie można zastąpić drugą metodę, taką jak , w celu dodania parametrów dynamicznych do polecenia NewDrive
New-PSDrive
NewDriveDynamicParameters
cmdlet.
Metoda InitializeDefaultDrives definiuje dyski domyślne, które są dostępne dla użytkownika za każdym razem, gdy dostawca jest używany.
Metody NewDrive i NewDriveDynamicParameters definiują sposób, w jaki dostawca obsługuje
New-PSDrive
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi tworzenie dysków w celu uzyskania dostępu do magazynu danych.Metoda RemoveDrive definiuje sposób, w jaki dostawca obsługuje
Remove-PSDrive
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi usuwanie dysków z magazynu danych.
Dostawcy z włączoną obsługą elementów
Dostawcy z włączoną obsługą elementów umożliwiają użytkownikowi uzyskiwanie, ustawianie lub wyczyszczenie elementów w magazynie danych. "Element" to element magazynu danych, do których użytkownik może niezależnie uzyskać dostęp lub zarządzać nimi. Aby utworzyć dostawcę z obsługą elementów, klasa dostawcy musi pochodzić z klasy System.Management.Automation.Provider.ItemCmdletProvider lub innej klasy pochodzącej od tej klasy.
Klasa ItemCmdletProvider definiuje następujące metody implementowania określonych polecenia cmdlet dostawcy. W większości przypadków w celu obsługi polecenia cmdlet dostawcy należy zastąpić metodę wywoływaną przez aparat programu PowerShell w celu wywołania polecenia cmdlet, taką jak metoda polecenia cmdlet, i opcjonalnie można zastąpić drugą metodę, taką jak , w celu dodania parametrów dynamicznych do polecenia ClearItem
Clear-Item
ClearItemDynamicParameters
cmdlet.
Metody ClearItem i ClearItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Clear-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi usunięcie wartości elementu w magazynie danych.Metody GetItem i GetItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Get-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi pobieranie danych z magazynu danych.Metody SetItem i SetItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Set-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi aktualizowanie wartości elementów w magazynie danych.Metody InvokeDefaultAction i InvokeDefaultActionDynamicParameters definiują sposób, w jaki dostawca obsługuje
Invoke-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi wykonanie domyślnej akcji określonej przez element.Metody ItemExists i ItemExistsDynamicParameters definiują sposób, w jaki dostawca obsługuje
Test-Path
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi ustalenie, czy istnieją wszystkie elementy ścieżki.
Oprócz metod używanych do implementowania polecenia cmdlet dostawcy klasa ItemCmdletProvider definiuje również następujące metody:
Metoda ExpandPath umożliwia użytkownikowi używanie symboli wieloznacznych podczas określania ścieżki dostawcy.
IsValidPath służy do określania, czy ścieżka jest prawidłowa syntaktycznie i semantycznie dla dostawcy.
Dostawcy z obsługą kontenerów
Dostawcy z włączoną obsługą kontenerów umożliwiają użytkownikowi zarządzanie elementami, które są kontenerami. Kontener to grupa elementów nadrzędnych w ramach wspólnego elementu nadrzędnego. Aby utworzyć dostawcę z obsługą kontenera, klasa dostawcy musi pochodzić z klasy System.Management.Automation.Provider.ContainerCmdletProvider lub innej klasy pochodzącej od tej klasy.
Ważne
Dostawcy z włączoną obsługą kontenerów nie mogą uzyskać dostępu do magazynów danych, które zawierają zagnieżdżone kontenery. Jeśli element podrzędny kontenera jest innym kontenerem, należy zaimplementować dostawcę z włączoną nawigacją.
Klasa ContainerCmdletProvider definiuje następujące metody implementowania określonych cmdlet dostawcy. W większości przypadków w celu obsługi polecenia cmdlet dostawcy należy zastąpić metodę wywoływaną przez aparat programu PowerShell w celu wywołania polecenia cmdlet, taką jak metoda polecenia cmdlet, i opcjonalnie można zastąpić drugą metodę, taką jak , w celu dodania parametrów dynamicznych do polecenia CopyItem
Copy-Item
CopyItemDynamicParameters
cmdlet.
Metody CopyItem i CopyItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Copy-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi kopiowanie elementu z jednej lokalizacji do innej.Metody GetChildItems i GetChildItemsDynamicParameters definiują sposób, w jaki dostawca obsługuje
Get-ChildItem
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi pobieranie elementów podrzędnych elementu nadrzędnego.Metody GetChildNames i GetChildNamesDynamicParameters definiują sposób, w jaki dostawca obsługuje polecenie cmdlet dostawcy, jeśli określono
Get-ChildItem
jegoName
parametr.Metody NewItem i NewItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
New-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi tworzenie nowych elementów w magazynie danych.Metody RemoveItem i RemoveItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Remove-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi usuwanie elementów z magazynu danych.Metody RenameItem i RenameItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Rename-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi zmianę nazw elementów w magazynie danych.
Oprócz metod używanych do implementowania polecenia cmdlet dostawcy klasa ContainerCmdletProvider definiuje również następujące metody:
Metoda HasChildItems może być używana przez klasę dostawcy do określenia, czy element ma elementy podrzędne.
Metoda ConvertPath może być używana przez klasę dostawcy do tworzenia nowej ścieżki specyficznej dla dostawcy z określonej ścieżki.
Dostawcy z włączoną nawigacją
Dostawcy z włączoną nawigacją umożliwiają użytkownikowi przenoszenie elementów w magazynie danych. Aby utworzyć dostawcę z włączoną nawigacją, klasa dostawcy musi pochodzić z klasy System.Management.Automation.Provider.NavigationCmdletProvider.
Klasa NavigationCmdletProvider definiuje następujące metody implementowania określonych dostawców cmdlet. W większości przypadków w celu obsługi polecenia cmdlet dostawcy należy zastąpić metodę wywoływaną przez aparat programu PowerShell w celu wywołania polecenia cmdlet, taką jak metoda polecenia cmdlet, i opcjonalnie można zastąpić drugą metodę, taką jak , w celu dodania parametrów dynamicznych do polecenia MoveItem
Move-Item
MoveItemDynamicParameters
cmdlet.
Metody MoveItem i MoveItemDynamicParameters definiują sposób, w jaki dostawca obsługuje
Move-Item
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi przeniesienie elementu z jednej lokalizacji w magazynie do innej lokalizacji.Metoda MakePath definiuje sposób, w jaki dostawca obsługuje
Join-Path
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi połączenie segmentu ścieżki nadrzędnej i podrzędnej w celu utworzenia ścieżki wewnętrznej dostawcy.
Oprócz metod używanych do implementowania polecenia cmdlet dostawcy klasa NavigationCmdletProvider definiuje również następujące metody:
Metoda GetChildName wyodrębnia nazwę węzła podrzędnego ścieżki.
Metoda GetParentPath wyodrębnia nadrzędną część ścieżki.
Metoda IsItemContainer określa, czy element jest elementem kontenera. W tym kontekście kontener jest grupą elementów nadrzędnych w ramach wspólnego elementu nadrzędnego.
Metoda NormalizeRelativePath zwraca ścieżkę do elementu, który jest względny dla określonej ścieżki podstawowej.
Dostawcy z włączoną zawartością
Dostawcy z włączoną zawartością umożliwiają użytkownikowi wyczyszczenie, pobrać lub ustawić zawartość elementów w magazynie danych. Na przykład dostawca fileSystem umożliwia wyczyszczenie, pobrać i ustawić zawartość plików w systemie plików. Aby utworzyć dostawcę z włączoną zawartością, klasa dostawcy musi implementować metody interfejsu System.Management.Automation.Provider.IContentCmdletProvider.
Interfejs IContentCmdletProvider definiuje następujące metody implementowania określonych polecenia cmdlet dostawcy. W większości przypadków w celu obsługi polecenia cmdlet dostawcy należy zastąpić metodę wywoływaną przez aparat programu PowerShell w celu wywołania polecenia cmdlet, taką jak metoda polecenia cmdlet, i opcjonalnie można zastąpić drugą metodę, taką jak , w celu dodania parametrów dynamicznych do polecenia ClearContent
Clear-Content
ClearContentDynamicParameters
cmdlet.
Metody ClearContent i ClearContentDynamicParameters definiują sposób, w jaki dostawca obsługuje
Clear-Content
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi usunięcie zawartości elementu bez usuwania elementu.Metody GetContentReader i GetContentReaderDynamicParameters definiują sposób, w jaki dostawca obsługuje
Get-Content
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi pobranie zawartości elementu. MetodaGetContentReader
zwraca interfejs System.Management.Automation.Provider.IContentReader, który definiuje metody używane do odczytywania zawartości.Metody GetContentWriter i GetContentWriterDynamicParameters definiują sposób, w jaki dostawca obsługuje
Set-Content
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi aktualizowanie zawartości elementu. MetodaGetContentWriter
zwraca interfejs System.Management.Automation.Provider.IContentWriter, który definiuje metody używane do pisania zawartości.
Dostawcy z włączoną właściwością
Dostawcy z włączoną właściwością umożliwiają użytkownikowi zarządzanie właściwościami elementów w magazynie danych.
Aby utworzyć dostawcę z włączoną właściwością, klasa dostawcy musi implementować metody interfejsów System.Management.Automation.Provider.IPropertyCmdletProvider i System.Management.Automation.Provider.IDynamicPropertyCmdletProvider. W większości przypadków w celu obsługi polecenia cmdlet dostawcy należy zastąpić metodę wywoływaną przez aparat programu PowerShell w celu wywołania polecenia cmdlet , taką jak metoda polecenia cmdlet programu Clear-Property, i opcjonalnie można zastąpić drugą metodę, taką jak , w celu dodania parametrów dynamicznych do polecenia ClearProperty
ClearPropertyDynamicParameters
cmdlet.
Interfejs IPropertyCmdletProvider definiuje następujące metody implementowania określonych cmdlet dostawcy:
Metody ClearProperty i ClearPropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Clear-ItemProperty
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi usunięcie wartości właściwości.Metody GetProperty i GetPropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Get-ItemProperty
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi pobranie właściwości elementu.Metody SetProperty i SetPropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Set-ItemProperty
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi aktualizowanie właściwości elementu.
Interfejs IDynamicPropertyCmdletProvider definiuje następujące metody implementowania określonych cmdlet dostawcy:
Metody CopyProperty i CopyPropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Copy-ItemProperty
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi kopiowanie właściwości i jej wartości z jednej lokalizacji do innej.Metody MoveProperty i MovePropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Move-ItemProperty
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi przeniesienie właściwości i jej wartości z jednej lokalizacji do innej.Metody NewProperty i NewPropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
New-ItemProperty
polecenie cmdlet dostawcy. To polecenie cmdlet umożliwia użytkownikowi utworzenie nowej właściwości i ustawienie jej wartości.Metody RemoveProperty i RemovePropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Remove-ItemProperty
polecenie cmdlet. To polecenie cmdlet umożliwia użytkownikowi usunięcie właściwości i jej wartości.Metody RenameProperty i RenamePropertyDynamicParameters definiują sposób, w jaki dostawca obsługuje
Rename-ItemProperty
polecenie cmdlet. To polecenie cmdlet umożliwia użytkownikowi zmianę nazwy właściwości.
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla