Kullanıcı arabirimini etkileyen paket PowerShell Galerisi değerleri
Bu konu, yayımcılara, PowerShellGet cmdlet'lerinin ve PowerShell Galerisi kullanıcı arabiriminin özelliklerinin etkilenmesi için PowerShell Galerisi yayınlarının bildirimini nasıl değiştirecekleri hakkında özet bilgiler sağlar. Bu içerik, orta bölümden başlayarak değişikliğin, sol tarafta gezinti alanıyla birlikte görünerek düzenleniyor. Önemli etiketleri ve yaygın olarak kullanılan bazı etiketleri tanımlayan etiketleri kapsayan bir ayrıntı bölümü vardır. Bildirim örnekleri sağlayan iki konu vardır:
- Modüller için bkz. Modül Bildirimini Güncelleştirme
- Betikler için bkz. Meta Verilerle Betik Dosyası Oluşturma
PowerShell Galerisi Tarafından Denetlenen Özellik Öğeleri
Aşağıdaki tabloda yayımcı tarafından denetlenen PowerShell Galerisi sayfası kullanıcı arabiriminin öğeleri gösterilmiştir. Her öğe, modülün veya betik bildiriminin denetlenerek denetlenene bir öğe olduğunu gösterir.
| Arabirim Öğesi | Description | Modül | Komut Dosyası |
|---|---|---|---|
| Başlık | Bu, Galeri'de yayımlanan paketin adıdır | Hayır | Hayır |
| Sürüm | Görüntülenen sürüm meta verilerde sürüm dizesi ve belirtilirse bir ön sürümdür. Modül bildiriminde sürümün birincil bölümü ModuleVersion'dır. Bir betik için olarak tanımlanır. SÜRÜM. Bir ön sürüm dizesi belirtilirse, modüller için ModuleVersion'a eklenir veya bir parçası olarak belirtilir. Betikler için VERSION. modüllerinde ve betiklerde ön koşul dizelerini belirtmeyeilişkin belgeler vardır | Yes | Yes |
| Açıklama | Bu, modül bildiriminde Açıklama, betik dosyası bildiriminde ise olur. AÇIKLAMA | Yes | Yes |
| Lisans kabulü gerektir | Modül, modül bildirimini RequireLicenseAcceptance = $true ile değiştirerek, bir LicenseURI sağlayarak ve modül klasörünün kökünde bir license.txt dosyası sağlayarak kullanıcının lisans kabul etmelerini gerekli kabilirsiniz. Ek bilgiler Lisans Kabulü Gerektir konu başlığı altında mevcuttur. | Yes | Hayır |
| Sürüm notları | Modüller için bu bilgiler, PSData\PrivateData altındaki ReleaseNotes bölümünden çizilir. Betik bildirimlerde ise olur. RELEASENOTES öğesi. | Yes | Yes |
| Sahipler | Sahipler, bir paketi güncelleştiren PowerShell Galerisi kullanıcıların listesidir. Sahip listesi paket bildirimine dahil değildir. Ek belgeler, öğe sahiplerini yönetmeyi açıklar. | Hayır | Hayır |
| Yazma | Bu, modül bildirimine Yazar olarak ve olarak bir betik bildirimine dahil edilir. YAZAR. Yazar alanı genellikle bir paketle ilişkili bir şirket veya kuruluş belirtmek için kullanılır. | Yes | Yes |
| Telif hakkı | Bu, ve modül bildiriminde Telif Hakkı alanıdır. Bir betik bildiriminde TELIF HAKKı. | Yes | Yes |
| Filelist | Dosya listesi, PowerShell Galerisi. Bildirim bilgileri tarafından kontrol edilemez. Not: Pakette her paketle birlikte listelenen ek bir .nuspec PowerShell Galerisi, paketi bir sisteme yükledikten sonra mevcut değildir. Bu, paketin Nuget paket bildirimidir ve yoksayılabilir. | Hayır | Hayır |
| Etiketler | Modüller için Etiketler PSData\PrivateData altına dahil edilir. Betikler için bölümü etiketlenmiş. ETİKETLER. Etiketler tırnak içinde olsalar bile boşluk içeremez. Etiketlerin ek gereksinimleri ve anlamları vardır ve bu konu, Etiket Ayrıntıları bölümünde daha sonra açıklanmıştır. | Yes | Yes |
| Cmdlet’ler | Bu cmdlet'lerToExport kullanılarak modül bildiriminde sağlanır. Kullanıcılar için yük modülü performansını geliştirecek olan "*" joker karakteri yerine öğeleri açıkça listelenin en iyi uygulamanın olduğunu unutmayın. | Yes | Hayır |
| İşlevler | Bu, FunctionsToExport kullanılarak modül bildiriminde sağlanır. Kullanıcılar için yük modülü performansını geliştirecek olan "*" joker karakteri yerine öğeleri açıkça listelenin en iyi uygulamanın olduğunu unutmayın. | Yes | Hayır |
| DSC Kaynakları | PowerShell sürüm 5.0 ve üzerinde kullanılacak modüller için bu, DscResourcesToExport kullanılarak bildirimde sağlanır. Modül PowerShell 4'te kullanılacaksa DSCResourcesToExport, desteklenen bir bildirim anahtarı değildir. (DSC, PowerShell 4'den önce kullanılabilirdi.) | Yes | Hayır |
| İş Akışları | İş akışları, PowerShell Galerisi olarak yayımlanır ve kodda iş Bağlan (örneğin AzureVM'ye bakın) olarak tanımlanır. Bu, bildirim tarafından denetlenz. | Hayır | Hayır |
| Rol özellikleri | Bu, MODÜLde yayımlanan modül JEA tarafından PowerShell Galerisi bir veya daha fazla rol özelliği (.psrc) dosyası içerdiğinde listelenir. Rol özellikleri hakkında daha fazla bilgi için JEA belgelerine bakın. | Yes | Hayır |
| PowerShell Sürümleri | Bu, bir betik veya modül bildiriminde belirtilir. PowerShell 5.0 ve altı ile birlikte kullanılacak şekilde tasarlanmış modüller için bu, Etiketler kullanılarak denetlenmektedir. Masaüstü için PSEdition_Desktop etiketini kullanın ve çekirdek için, PSEdition_Core etiketini kullanın. Yalnızca PowerShell 5,1 ve üzeri sürümlerde kullanılacak modüller için ana bildirimde bir CompatiblePSEditions anahtarı vardır. Daha fazla ayrıntı için PowerShell Get BELGELERINDEKIPS sürümü özelliğini gözden geçirin. | Yes | Yes |
| Bağımlılıklar | Bağımlılıklar, modülde RequiredModules olarak veya betik bildiriminde #Requires – Module (ad) olarak belirtilen PowerShell Galerisi modüllerdir. | Yes | Yes |
| En düşük PowerShell sürümü | Bu, bir modül bildiriminde PowerShellVersion olarak belirtilebilir | Yes | Hayır |
| Sürüm geçmişi | Sürüm geçmişi, PowerShell Galerisi bir modüle yapılan güncelleştirmeleri yansıtır. Bir paketin bir sürümü Sil özelliği kullanılarak gizliyse, paket sahipleri hariç sürüm geçmişi 'nde görüntülenmez. | Hayır | Hayır |
| Project Bölgesi | Proje sitesi, bir ProjectURI belirterek modül bildiriminin Privatedata\PSData bölümünde modüller için sağlanır. Betik bildiriminde, belirterek denetlenir. PROJECTURI. | Yes | Yes |
| Lisans | Bir LicenseURI belirterek modül bildiriminin Privatedata\PSData bölümünde modüller için bir lisans bağlantısı sağlanır. Betik bildiriminde, belirterek denetlenir. LICENSEURI. Bir lisans LicenseURI ile veya bir modül içinde sağlanmamışsa, PowerShell Galerisi için Kullanım Koşulları ' nın paket için kullanım koşullarını belirtmesini sağlamak önemlidir. Ayrıntılar için Kullanım Koşulları ' na bakın. | Yes | Yes |
| Simge | Komut dosyası bildiriminde Iuri bayrağını veya modül bildiriminin Privatedata-PSData bölümünde bir simge, PowerShell Galerisi herhangi bir paket için belirtilebilir. Iuri, saydamlık arka planına sahip bir 85x85 resmine işaret etmelidir. URI bir doğrudan görüntü URL 'si olmalıdır ve görüntünün veya PowerShell Galerisi paketindeki bir dosyanın bulunduğu bir Web sayfasına gitmemelidir . | Yes | Yes |
Paket ayrıntılarını Düzenle
PowerShell Galerisi paketi düzenleme sayfası, yayımcıların bir paket için görüntülenecek alanların birkaçını değiştirmesine olanak tanır, özellikle:
- Başlık
- Açıklama
- Özet
- Simge URL'si
- Project giriş sayfası URL 'si
- Yazarlar
- Telif Hakkı
- Etiketler
- Sürüm notları
- Lisans gerektir
Bu yaklaşım, bir modülün eski bir sürümü için neyin görüntülendiğini düzeltmek için gerekli olduğu durumlar dışında, genel olarak önerilmez. Modülü elde eden kullanıcılar, bu, paket hakkında kaygıları oluşturan PowerShell Galerisi, meta verilerin görüntülendiklerle eşleşmediğinden bu verileri görür. Bu, sıklıkla değişikliği onaylamak için paket sahipleriyle ilgili sorgular oluşmasına neden olur. Bu yaklaşımın her seferinde kullanılması önemle önerilir, paketin yeni bir sürümü aynı değişikliklerle yayımlanmalıdır.
Etiket ayrıntıları
Etiketler, tüketicilerin paketleri bulmak için kullanacağı basit dizeler. Etiketler, aynı konuyla ilgili birçok paket arasında tutarlı olarak kullanıldıkları zaman en değerlidir. Aynı sözcüğün (örneğin, veritabanı ve veritabanları veya test ve test) birden çok türünü kullanmak genellikle biraz avantaj sağlar. Etiketler tek sözcüklü büyük küçük harf duyarsız dizelerdir ve boşluk içeremez. Kullanıcılara arama yapılacak bir tümcecik varsa, bunu paket açıklamasına ekleyin ve arama sonuçlarında bulunur. Okunabilirliği artırmaya çalışıyorsanız,, kısa çizgi, tire, alt çizgi veya nokta kullanın. Genellikle yanlış yazıldıklarından uzun, karmaşık ve olağandışı Etiketler oluşturma konusunda dikkatli olun.
PowerShell Galerisi ve PowerShellGet cmdlet 'lerinin benzersiz şekilde davranmasıyla, dikkat edilmesi gereken Etiketler vardır. PSEdition_Desktop ve PSEdition_Core, belirli örneklerdir ve yukarıda açıklanmıştır.
Yukarıda belirtildiği gibi, Etiketler, belirli oldukları sırada en fazla değeri sağlar ve tutarlı olarak birçok paket arasında kullanılır. Kullanmak için en iyi etiketleri bulmaya çalışan bir yayımcı olarak en kolay yaklaşım, PowerShell Galerisi göz önünde bulundururken kullanabileceğiniz Etiketler için arama kullanmaktır. İdeal olarak, çok sayıda paket döndürülür ve paket açıklamaları bu anahtar sözcüğünü kullanmanıza göre hizalanır.
Başvuru için, 12/14/2017 itibariyle en yaygın olarak kullanılan birkaç etiket aşağıda verilmiştir. Bazı durumlarda, etiketin yanında listelenen benzer ancak belki daha az ideal seçenek vardır. Tercih edilen etiketin kullanılması, daha az gürültü ve tüketicilere yönelik daha iyi arama sonuçlarıyla sonuçlanacağı için en iyi uygulamadır.
| Tercih edilen etiket | Alternatifler ve notlar |
|---|---|
| Azure | |
| DSC | DesiredStateConfiguration daha az istenmiş, çok uzun |
| ResourceManager | "ARM" işlemci grubunu anlatmak için kullanılır ve Azure Resource Manager için kullanılmamalıdır |
| DSCResourceKit | |
| SQL | |
| AWS | |
| DSCResource | |
| Otomasyon | |
| REST | |
| ActiveDirectory | AD Şu anda kendisi tarafından kullanılmıyor |
| SQLServer | |
| DBA | |
| Güvenlik | Savunma daha az kesin |
| Veritabanı | Veritabanları (plural) daha az tercih edilir |
| DevOps | |
| Windows | |
| Oluşturma | |
| Dağıtım | Dağıtım biraz daha az kullanılır |
| Bulut | |
| GIT | |
| Test etme | Test daha az tercih edilir |
| VersionControl | Daha sık kullanılmakla, sürüm daha az kesin |
| Günlüğe Kaydetme | Eylem olarak günlüğe kaydetmenin tercih edilen kullanımı |
| Günlük | Günlük'in bir şey olarak tercih edilen kullanımı |
| Backup | |
| IaaS | |
| Linux | |
| IIS | |
| AzureAutomation | |
| Depolama | |
| GitHub | |
| Json | |
| Exchange | |
| Ağ | Ağ benzerdir, daha az kullanılır |
| SharePoint | |
| Raporlama | Raporlama bir eylemdir, rapor bir şeydir |
| Rapor | Rapor bir şeydir |
| WinRM | |
| İzleme | |
| VSTS | |
| Excel | |
| Renk | |
| DNS | |
| Office365 | Yazımı Office tercih edilir. O365 daha az yaygın olarak kullanılır, ancak daha kısadır |
| Gitlab | |
| Rahatsız | |
| AzureAD | |
| HTML | |
| Hyper-V | HyperV, etiket olarak daha az yaygındır |
| Yapılandırma | |
| ChatOps | |
| PackageManagement | |
| WMI | |
| Güvenlik Duvarı | |
| Docker | |
| Appveyor | |
| AzureRm | Öncelikli olarak AzureRM modülleri için kullanılır |
| Zip | |
| MSI | |
| macOS | |
| PoshBot |