Windows PowerShell Sağlayıcısına Genel Bakış

Windows PowerShell sağlayıcısı, tüm veri depolarının bağlı bir sürücü gibi dosya sistemi gibi kullanıma sunulmasını sağlar. Örneğin, yerleşik Kayıt Defteri sağlayıcısı, bilgisayarınızın c sürücüsünde gezindiğiniz gibi kayıt defterinde gezinmenizi sağlar. Bir sağlayıcı, veri deponuzdaki verilerin dosya ve dizinler gibi işlenebilir olması için Item cmdlet'lerini (örneğin, Get-Item, Set-Itemvb.) geçersiz kılabilir. Sağlayıcılar ve sürücüler ve Windows PowerShell'deki yerleşik sağlayıcılar hakkında daha fazla bilgi için bkz. about_Providers.

Sağlayıcılar ve Sürücüler

Sağlayıcı, veri deposuna erişmek, veri deposuna erişmek, gezinmek ve bunları düzenlemek için kullanılan mantığı tanımlarken sürücü, sağlayıcı tarafından tanımlanan türde bir veri deposuna (veya veri deposunun bir bölümüne) belirli bir giriş noktası belirtir. Örneğin, Kayıt Defteri sağlayıcısı bir kayıt defterindeki kovanlara ve anahtarlara erişmenize olanak tanır ve HKLM ve HKCU sürücüleri kayıt defterindeki ilgili kovanları belirtir. HKLM ve HKCU sürücülerinin her ikisi de Kayıt Defteri sağlayıcısını kullanır.

Sağlayıcı yazarken, sağlayıcı kullanılabilir olduğunda otomatik olarak oluşturulan varsayılan sürücüleri belirtebilirsiniz. Ayrıca bu sağlayıcıyı kullanan yeni sürücüler oluşturmak için bir yöntem de tanımlarsınız.

Sağlayıcı Türü

Her biri farklı bir işlevsellik düzeyi sağlayan çeşitli sağlayıcı türleri vardır. Sağlayıcı, System.Management.Automation.SessionStateCategoryCmdletProvider sınıfının alt öğelerinden birinden türetilen bir sınıf olarak uygulanır. Farklı sağlayıcı türleri hakkında bilgi için bkz. Sağlayıcı türleri.

Sağlayıcı cmdlet’leri

Sağlayıcılar cmdlet'lere karşılık gelen yöntemler uygulayabilir ve bu sağlayıcı için bir sürücüde kullanıldığında bu cmdlet'ler için özel davranışlar oluşturabilir. Sağlayıcının türüne bağlı olarak, farklı cmdlet kümeleri kullanılabilir. Sağlayıcılarda özelleştirme için kullanılabilen cmdlet'lerin tam listesi için bkz. Sağlayıcı cmdlet'leri.

Sağlayıcı yolları

Kullanıcılar dosya sistemleri gibi sağlayıcı sürücülerde gezinebilir. Bu nedenle, yolların söz diziminin dosya sistemi gezintisinde kullanılan yollara karşılık gelmesini beklerler. Kullanıcı bir sağlayıcı cmdlet'i çalıştırdığında, erişilecek öğenin yolunu belirtir. Belirtilen yol çeşitli şekillerde yorumlanabilir. Sağlayıcı aşağıdaki yol türlerinden birini veya daha fazlasını desteklemelidir.

Sürücüye uygun yollar

Sürücüye uygun yol, öğe adı, öğenin bulunduğu kapsayıcı ve alt kapsayıcılar ile öğenin erişildiği Windows PowerShell sürücüsünün birleşimidir. (Sürücüler, veri deposuna erişmek için kullanılan sağlayıcı tarafından tanımlanır. Bu yol, sürücü adıyla başlar ve ardından iki nokta üst üste (:). Örneğin: Get-ChildItem C:

Sağlayıcı tarafından nitelenmiş yollar

Windows PowerShell altyapısının sağlayıcınızı başlatmasına ve başlatmasını kaldırmasına izin vermek için sağlayıcının sağlayıcıya uygun bir yolu desteklemesi gerekir. Örneğin, kullanıcı filesystem sağlayıcısını başlatabilir ve başlatabilir çünkü şu sağlayıcıya uygun yolu tanımlar: FileSystem::\\uncshare\abc\bar.

Sağlayıcı doğrudan yolları

Windows PowerShell sağlayıcınıza uzaktan erişime izin vermek için, geçerli konum için doğrudan Windows PowerShell sağlayıcısına geçecek bir sağlayıcı doğrudan yolunu desteklemelidir. Örneğin, kayıt defteri Windows PowerShell sağlayıcısı, sağlayıcı doğrudan yolu olarak \\server\regkeypath kullanabilir.

Sağlayıcı-iç yollar

Sağlayıcı cmdlet'inin Windows dışındaki PowerShell uygulama programlama arabirimlerini (API' ler) kullanarak verilere erişmesine izin vermek için, Windows PowerShell sağlayıcınız sağlayıcı-iç yolunu desteklemelidir. Bu yol, sağlayıcıya uygun yolda "::" işaretinden sonra gösterilir. Örneğin, FileSystem Windows PowerShell sağlayıcısının sağlayıcı-iç yolu \\uncshare\abc\bar.

Cmdlet parametrelerini geçersiz kılma

Sağlayıcıya özgü bazı cmdlet'lerin davranışı bir sağlayıcı tarafından geçersiz kılınabilir. Geçersiz kılınabilecek parametrelerin listesi ve bunların sağlayıcı sınıfınızda nasıl geçersiz kılınacağı için bkz. Sağlayıcı cmdlet parametreleri

Dinamik parametreler

Sağlayıcılar, kullanıcı cmdlet'in statik parametrelerinden biri için belirli bir değer belirttiğinde sağlayıcı cmdlet'ine eklenen dinamik parametreleri tanımlayabilir. Sağlayıcı bunu bir veya daha fazla dinamik parametre yöntemi uygulayarak yapar. Dinamik parametre eklemek için kullanılabilecek cmdlet parametrelerinin ve bunları uygulamak için kullanılan yöntemlerin listesi için bkz. Sağlayıcı cmdlet dinamik parametreleri.

Sağlayıcı özellikleri

System.Management.Automation.Provider.ProviderCapabilities numaralandırması, sağlayıcıların destekleyebilecekleri bir dizi özelliği tanımlar. Bunlar joker karakter kullanma, öğeleri filtreleme ve işlemleri destekleme özelliğini içerir. Bir sağlayıcının özelliklerini belirtmek için, System.Management.Automation.Provider.ProviderCapabilities numaralandırmasının değerlerinin listesini ekleyin. mantıksal OR işlemiyle birleştirildiğinde, sağlayıcı sınıfınız için System.Management.Automation.Provider.CmdletProviderAttribute.ProviderCapabilities* özelliği (özniteliğin ikinci parametresi) System.Management.Automation.Provider.CmdletProviderAttribute özniteliğidir. Örneğin, aşağıdaki öznitelik sağlayıcının System.Management.Automation.Provider.ProviderCapabilitiesShouldProcess ve System.Management.Automation.Provider.ProviderCapabilitiesİşlemler özelliklerini desteklediğini belirtir.

[CmdletProvider(RegistryProvider.ProviderName, ProviderCapabilities.ShouldProcess | ProviderCapabilities.Transactions)]

Sağlayıcı cmdlet'i yardımı

Sağlayıcı yazarken, desteklediğiniz sağlayıcı cmdlet'leri için kendi Yardımınızı uygulayabilirsiniz. Bu, her sağlayıcı cmdlet'i için tek bir yardım konusu veya sağlayıcı cmdlet'inin dinamik parametrelerin kullanımına göre farklı davrandığı durumlar için bir yardım konusunun birden çok sürümünü içerir. Sağlayıcı cmdlet'ine özgü yardımı desteklemek için sağlayıcınızın System.Management.Automation.Provider.ICmdletProviderSupportsHelp arabirimini uygulaması gerekir.

Windows PowerShell altyapısı, sağlayıcı cmdlet'lerinizin Yardım konusunu görüntülemek için System.Management.Automation.Provider.ICmdletProviderSupportsHelp.GetHelpMaml* yöntemini çağırır. Altyapı, kullanıcının Get-Help cmdlet'ini çalıştırırken belirttiği cmdlet'in adını ve kullanıcının geçerli yolunu sağlar. Sağlayıcınız farklı sürücüler için aynı sağlayıcı cmdlet'in farklı sürümlerini uyguluyorsa geçerli yol gereklidir. yöntemi, cmdlet Yardımı için XML'yi içeren bir dize döndürmelidir.

Yardım dosyasının içeriği PSMAML XML kullanılarak yazılır. Bu, tek başına cmdlet'ler için Yardım içeriği yazmak için kullanılan XML şemasıyla aynıdır. Özel cmdlet Yardımınızın içeriğini, CmdletHelpPaths öğesinin altında sağlayıcınızın Yardım dosyasına ekleyin. Aşağıdaki örnekte tek bir sağlayıcı cmdlet'i için command öğesi ve sağlayıcınızın sağlayıcı cmdlet'inin adını nasıl belirttiğiniz gösterilmektedir. Destekle -yen

<CmdletHelpPaths>
  <command:command>
    <command:details>
      <command:name>ProviderCmdletName</command:name>
      <command:verb>Verb</command:verb>
      <command:noun>Noun</command:noun>
    <command:details>
  </command:command>
<CmdletHelpPath>

Ayrıca Bkz.

Windows PowerShell Sağlayıcısı İşlevselliği

Sağlayıcı Cmdlet'leri

Windows PowerShell Sağlayıcısı yazma