Out-GridView
Çıktıyı etkileşimli bir tabloya ayrı bir pencerede gönderir.
Syntax
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-PassThru]
[<CommonParameters>] Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-Wait]
[<CommonParameters>] Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-OutputMode <OutputModeOption>]
[<CommonParameters>] Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Cmdlet, Out-GridView bir komuttan çıktıyı, çıktının etkileşimli bir tabloda görüntülendiği kılavuz görünümü penceresine gönderir.
Bu cmdlet bir kullanıcı arabirimi gerektirdiği için Windows Server Core veya Windows Nano Server üzerinde çalışmaz.
Verilerinizi incelemek için tablonun aşağıdaki özelliklerini kullanabilirsiniz:
- Sütunları gizleme, gösterme ve yeniden sıralama
- Satırları sıralama
- Hızlı filtre
- Ölçüt filtresi ekleme
- Kopyala ve yapıştır
Tam yönergeler için bu makalenin Notlar bölümüne bakın.
Not
Bu cmdlet PowerShell 7'de yeniden tanıtıldı. Bu cmdlet yalnızca Windows Masaüstü'nü destekleyen Windows sistemlerinde kullanılabilir. Bu cmdlet'in platformlar arası sürümü için PowerShell Galerisi consoleguitools modülüne bakın.
Örnekler
Örnek 1: Kılavuz görünümüne çıkış işlemleri
Bu örnek, yerel bilgisayarda çalışan işlemleri alır ve bunları bir kılavuz görünümü penceresine gönderir.
Get-Process | Out-GridViewÖrnek 2: İşlemleri kılavuz görünümüne çıkarmak için değişken kullanma
Bu örnek ayrıca yerel bilgisayarda çalışan işlemleri alır ve bunları bir kılavuz görünümü penceresine gönderir.
$P = Get-Process
$P | Out-GridViewCmdlet'in Get-Process çıkışı değişkene $P kaydedilir. Ardından öğesine $P yöneltilir Out-GridView.
Örnek 3: Seçili özellikleri kılavuz görünümünde görüntüleme
Bu örnek, çalışan işlemlerin seçili özelliklerini kılavuz görünümünde görüntüler.
Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
Sort-Object -Property WorkingSet -Descending | Out-GridViewçıktısı Get-Process Name, WorkingSet ve PeakWorkingSet özelliklerini seçmek için Select-Object öğesine yöneltilir. Başka bir işlem hattı işleci, filtrelenmiş nesneleri WorkingSet özelliğinin Sort-Object değerine göre azalan düzende sıralamak için cmdlet'ine gönderir.
Ardından, sıralanan sonuçlar öğesine Out-GridViewyönlendirilir. Artık kılavuz görünümünün özelliklerini kullanarak verileri arayabilir, sıralayabilir ve filtreleyebilirsiniz.
Örnek 4: Çıkışı bir değişkene kaydedin ve ardından bir kılavuz görünümü çıktısı yapın
Bu örnek, cmdlet çıkışını bir değişkene kaydeder ve ardından öğesine Out-GridViewgönderir.
($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridViewGet-ChildItem Otomatik değişkeni kullanarak $PSHOME PowerShell yükleme dizinindeki ve alt dizinlerindeki tüm dosyaları alır. Komutundaki parantezler işlemlerin sırasını oluşturur. Sonuç olarak, komutun Get-ChildItem çıkışı değişkenine $AOut-GridViewgönderilmeden önce kaydedilir.
Örnek 5: Belirtilen bir bilgisayar için kılavuz görünümüne çıkış işlemleri
Bu örnek, Server01 bilgisayarında çalışan işlemleri bir kılavuz görünümü penceresinde görüntüler.
Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"Örnekte ogvcmdlet'inin Out-GridView diğer adı olan kullanılır. Title parametresi pencere başlığını belirtir.
Örnek 6: Uzak bilgisayarlardan kılavuz görünümüne veri çıkışı
Bu örnekte, uzak bilgisayarlardan toplanan verilerin 'e nasıl gönderlandığı gösterilmektedir Out-GridView.
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridViewInvoke-Command üç uzak bilgisayarda çalışır Get-Culture . Sonuçta elde edilen veriler adresine Out-GridViewyöneltilir. Uzak bilgisayarda çalışan betik bloğunun komutunu içermediğini Out-GridView unutmayın. Bunu yaptıysa, uzak bilgisayarların her birinde bir kılavuz görünümü penceresi açmaya çalıştığında komut başarısız olur.
Örnek 7: 'Out-GridView' aracılığıyla birden çok öğe geçirme
Bu örnek, pencereden birden çok işlem seçmenize Out-GridView olanak tanır. Seçtiğiniz işlemler komutuna Export-Csv geçirilir ve dosyaya ProcessLog.csv yazılır.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvparametresi, Out-GridView işlem hattından birden çok öğe göndermenizi sağlar. PassThru parametresi, OutputMode parametresinin Multiple değerinin kullanılmasıyla eşdeğerdir.
Örnek 8: 'Out-GridView' için bir Windows kısayolu oluşturma
Bu örnekte, pencereye bir Windows kısayolu Out-GridView oluşturmak için Wait parametresinin nasıl kullanılacağı gösterilmektedirOut-GridView.
pwsh -Command "Get-Service | Out-GridView -Wait"Bu komut satırı bir Windows kısayolunda kullanılabilir. Wait parametresi olmadan, Pencere açılır açılmaz Out-GridView PowerShell çıkar ve bu da pencereyi hemen kapatırOut-GridView.
Parametreler
-InputObject
cmdlet'in için Out-GridViewgiriş olarak kabul eden nesneyi belirtir.
nesnesi koleksiyonu Out-GridViewOut-GridView göndermek için InputObject parametresini kullandığınızda, koleksiyonu tek bir koleksiyon nesnesi olarak değerlendirir ve koleksiyonu temsil eden bir satır görüntüler. Koleksiyondaki her nesneyi görüntülemek için, nesneleri Out-GridViewadresine göndermek için bir işlem hattı işleci (|) kullanın.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OutputMode
Etkileşimli pencerenin işlem hattını diğer komutlara giriş olarak gönderdiği öğeleri belirtir. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz. İşlem hattının alt kısmındaki etkileşimli pencereden öğe göndermek için öğeleri seçmek için tıklayın ve ardından Tamam'a tıklayın.
Bu parametrenin değerleri, işlem hattına kaç öğe gönderebileceğinizi belirler.
None. Öğe yok. Bu varsayılan değerdir.Single. Sıfır öğe veya bir öğe. Sonraki komut yalnızca bir giriş nesnesi alabiliyorsa bu değeri kullanın.Multiple. Sıfır, bir veya çok öğe. Sonraki komut birden çok giriş nesnesi alabiliyorsa bu değeri kullanın. Bu değer, Passthru parametresine eşdeğerdir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | OutputModeOption |
| Accepted values: | None, Single, Multiple |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Cmdlet'in etkileşimli pencereden diğer komutlara giriş olarak işlem hattının aşağısına öğe gönderdiğini gösterir. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz. Bu parametre, OutputMode parametresinin Multiple değerinin kullanılmasıyla eşdeğerdir.
İşlem hattının alt kısmındaki etkileşimli pencereden öğe göndermek için öğeleri seçmek için tıklayın ve ardından Tamam'a tıklayın. Shift-click ve Ctrl tuşunu basılı tutarak tıklama desteklenir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Title
Pencerenin başlık çubuğunda Out-GridView görüntülenen metni belirtir. Varsayılan olarak, başlık çubuğunda komutunu çağıran Out-GridViewkomut görüntülenir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Cmdlet'in komut istemini gizlediğini ve pencere kapatılana kadar Windows PowerShell'in kapanmasını önlediğini Out-GridView gösterir. Varsayılan olarak, pencere açıldığında Out-GridView komut istemi döndürülecektir.
Bu özellik, Windows kısayollarındaki Out-GridView cmdlet'leri kullanmanıza olanak tanır. Out-GridView Wait parametresi olmayan bir kısayolda kullanıldığında, Out-GridView pencere PowerShell kapanmadan önce yalnızca kısa bir süre görüntülenir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Girişler
Herhangi bir nesneyi bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet seçili satırları temsil eden nesneleri döndürür.
Notlar
PowerShell için aşağıdaki diğer adları Out-GridViewiçerir:
- Windows:
ogv
Bu cmdlet yalnızca Windows platformlarında kullanılabilir. Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
Başka bir bilgisayarda kılavuz görünümü penceresi açmak için uzak komut kullanamazsınız.
adresine gönderdiğiniz Out-GridView komut çıkışı, veya Format-Wide cmdlet'leri gibi Format-Table cmdlet'ler kullanılarak Format biçimlendirilemez. Özellikleri seçmek için cmdlet'ini Select-Object kullanın.
Uzak komutlardan seri durumdan çıkarılmış çıkış, kılavuz görünümü penceresinde doğru biçimlendirilmeyebilir.
Klavye KısayollarıOut-GridView
| Şu anahtarı kullanın: | Bu eylemi gerçekleştirmek için: |
|---|---|
| Sekme | İmleci Filtre kutusundan Ölçüt ekle menüsüne tabloya ve geri taşır. |
| UpArrow | Bir satır yukarı gitme. İlk veri satırından sütun üst bilgilerine geçer. |
| DownArrow | Bir satır aşağı gitme. |
| LeftArrow | Sütun üst bilgisi satırında, bir sütun sola gitme. |
| RightArrow | Sütun üst bilgisi satırında bir sütun sağa gitme. |
| ContextMenuKey | Sütun üst bilgisi satırında Sütunları Seç seçeneğini görüntüler. |
| Enter veya Boşluk Çubuğu | Sütun üst bilgisi satırında sütun verilerini sıralayın (A-Z, Z-A arasında geçiş). |
Kılavuz Görünümü Pencere Özelliklerini Kullanma
Sütunu gizlemek veya göstermek için:
- Herhangi bir sütun başlığına sağ tıklayın ve Sütunları Seç'e tıklayın.
- Sütunları Seç iletişim kutusunda, ok tuşlarını kullanarak seçili sütunlar arasındaki sütunları Kullanılabilir sütunlar kutularına taşıyın. Kılavuz görünümü penceresinde yalnızca Sütunları Seç kutusundaki sütunlar görüntülenir.
Sütunları yeniden sıralamak için:
Sütunları sürükleyip istediğiniz konuma bırakabilirsiniz. Veya aşağıdaki adımları kullanın:
- Herhangi bir sütun başlığına sağ tıklayın ve Sütunları Seç'e tıklayın.
- Sütunları Seç iletişim kutusunda, sütunları yeniden sıralamak için Yukarı taşı ve Aşağı taşı düğmelerini kullanın. Listenin en üstündeki sütunlar, kılavuz görünümü penceresinde listenin alt kısmındaki sütunların solunda görünür.
Tablo Verilerini Sıralama
- Verileri sıralamak için bir sütun üst bilgisine tıklayın.
- Sıralama düzenini değiştirmek için sütun üst bilgisine yeniden tıklayın. Aynı üst bilgiye her tıkladığınızda sıralama düzeni artan düzenden azalan düzene geçiş yapar. Geçerli sıra, sütun başlığındaki bir üçgenle gösterilir.
Tablo Verilerini Seçme
- Satır seçmek için satırı seçin veya satıra gitmek için yukarı veya aşağı oku kullanın.
- Tüm satırları seçmek için (üst bilgi satırı hariç) CTRL+A tuşuna basın.
- Ardışık satırları seçmek için, satırlara tıklarken veya ok tuşlarını kullanırken SHIFT tuşunu basılı tutun.
- Tutarsız satırları seçmek için CTRL tuşuna basın ve seçime satır eklemek için tıklayın.
- Sütunları seçemezsiniz ve sütun üst bilgisi satırının tamamını seçemezsiniz.
Satırları Kopyalama
Tablodan bir veya daha fazla satır kopyalamak için satırları seçin ve CTRL+C tuşlarına basın.
Verileri herhangi bir metin veya elektronik tablo programına yapıştırabilirsiniz. Sütunları veya satırların bölümlerini kopyalayamazsınız ve sütun üst bilgisi satırını kopyalayamazsınız.
Tabloda Arama (Hızlı Filtre)
Tablodaki verileri aramak için Filtre kutusunu kullanın. Kutuya yazdığınızda, tabloda yalnızca yazılan metni içeren öğeler görüntülenir.
Metin arayın. Tablodaki metni aramak için, Filtre kutusuna bulunacak metni yazın.
Birden çok sözcük arayın. Tabloda birden çok sözcük aramak için, sözcükleri boşluklarla ayırarak yazın.
Out-GridViewtüm sözcükleri (mantıksal VE) içeren satırları görüntüler.Değişmez tümcecikleri arayın. Boşluk veya özel karakter içeren tümcecikleri aramak için, tümceciği tırnak içine alın.
Out-GridViewtümcecik için tam eşleşme içeren satırları görüntüler.Sütunlarda arama yapma. Bir veya daha fazla sütunda metin aramak için aşağıdaki biçimi kullanın:
<column>:<text> [<column>:<text>] ...Örneğin, DisplayName sütunundaki Filtre kutusuna "Net"i bulmak için şunu yazın:
displayname:netDisplayName ve Name sütunlarında "Net" içeren satırları bulmak için, Filtre kutusuna şunu yazın:
displayname:net name:netAramayı kapatın. Tablonun tamamını yeniden görüntülemek için Filtre kutusunun sağ üst köşesindeki kırmızı X düğmesine tıklayın veya Filtre kutusundan metni silin.
Tabloyu Filtrelemek için Ölçüt Kullanma
Tabloda hangi öğelerin görüntüleneceğini belirlemek için kurallar veya ölçütler kullanabilirsiniz. Öğeler yalnızca sizin oluşturduğunuz tüm ölçütleri karşıladığında görünür. Kullanılabilir ölçütler, kılavuz görünümü penceresinde görüntülenen nesnelerin özelliklerine ve bu özelliklerin .NET Framework türlerine göre belirlenir.
Her ölçüt aşağıdaki biçime sahiptir:
<column> <operator> <value>
Farklı özelliklere yönelik ölçütler AND ile bağlanır. Aynı özelliğin ölçütleri OR ile bağlanır. Mantıksal bağlayıcıları değiştiremezsiniz.
Ölçütler yalnızca görüntüyü etkiler. Tablodaki öğeleri silmez.
Ölçüt Ekleme
- Ölçüt ekle menü düğmesini görüntülemek için pencerenin sağ üst köşesinde Genişlet okuna tıklayın.
- Ölçüt Ekle menü düğmesine tıklayın.
- Sütunları (özellikler) seçmek için tıklayın. Bir veya daha fazla özellik seçebilirsiniz.
- Özellikleri seçmeyi bitirdiğinizde Ekle düğmesine tıklayın.
- Eklemeleri iptal etmek için İptal'e tıklayın.
- Daha fazla ölçüt eklemek için Ölçüt Ekle düğmesine yeniden tıklayın.
Ölçüt Düzenleme
- Bir işleci değiştirmek için mavi işleç değerine tıklayın ve açılan listeden farklı bir işleç seçin.
- Değer girmek veya değiştirmek için değer kutusuna bir değer yazın. Geçerli olmayan bir değer girerseniz dairesel bir X simgesi görüntülenir. Kaldırmak için değeri değiştirin.
- OR deyimi oluşturmak için aynı özelliğe sahip bir ölçüt ekleyin.
Ölçütleri Silme
- Seçili ölçütleri silmek için her ölçütün yanındaki kırmızı X işaretine tıklayın.
- Tüm ölçütleri silmek için Tümünü Temizle düğmesine tıklayın.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin