Out-GridView (Microsoft.PowerShell.Utility)

Out-GridView

Modül:

Microsoft.PowerShell.Utility

Çıktıyı ayrı bir pencerede etkileşimli bir tabloya gönderir.

Sözdizimi

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>]

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Out-GridView cmdlet'i bir komuttan çıktıyı, çıktının etkileşimli bir tabloda görüntülendiği ızgara görünümü penceresine gönderir.

Bu cmdlet bir kullanıcı arabirimi gerektirdiğinden Windows Server Core veya Windows Nano Server'da çalışmaz.

Verilerinizi incelemek için tablonun aşağıdaki özelliklerini kullanabilirsiniz:

• Sütunları gizleyin, gösterin ve yeniden sıralayın
• Satırları sırala
• Hızlı filtre
• Ölçüt filtresi ekle
• Kopyala ve yapıştır

Talimatların tamamı için bu makalenin Notlar bölümüne bakın.

Örnekler

Örnek 1: İşlemlerin çıktısını ızgara görünümüne alın

Bu örnek, yerel bilgisayarda çalışan işlemleri alır ve bunları bir ızgara görünümü penceresine gönderir.

Get-Process | Out-GridView

Örnek 2: İşlemlerin çıktısını ızgara görünümüne almak için bir değişken kullanma

Bu örnek aynı zamanda yerel bilgisayarda çalışan işlemleri alır ve bunları bir ızgara görünümü penceresine gönderir.

$P = Get-Process
$P | Out-GridView

Get-Process cmdlet'inin çıktısı $P değişkenine kaydedilir. Daha sonra $P, Out-GridView'a aktarılır.

Örnek 3: Seçilen bir özelliği ızgara görünümünde görüntüleme

Bu örnek, çalışan işlemlerin seçilen özelliklerini ızgara görünümünde görüntüler.

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

Get-Process çıktısı, Ad, WorkingSet ve 'yi seçmek için Select-Object'e aktarılır >PeakWorkingSet özellikleri. Başka bir ardışık düzen operatörü, filtrelenen nesneleri WorkingSet özelliğinin değerine göre azalan düzende sıralamak için Sort-Object cmdlet'ine gönderir. Daha sonra sıralanan sonuçlar Out-GridView'a aktarılır. Artık verileri aramak, sıralamak ve filtrelemek için tablo görünümünün özelliklerini kullanabilirsiniz.

Örnek 4: Çıktıyı bir değişkene kaydedin ve ardından bir tablo görünümü çıktısı alın

Bu örnek, cmdlet çıktısını bir değişkene kaydeder ve ardından onu Out-GridView'a gönderir.

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem, PowerShell kurulum dizinindeki ve alt dizinlerindeki tüm dosyaları $PSHOME otomatik değişkenini kullanarak alır. Komuttaki parantezler işlem sırasını belirler. Sonuç olarak, Get-ChildItem komutunun çıktısı, Out-GridView'a gönderilmeden önce $A değişkenine kaydedilir.

Örnek 5: Belirtilen bir bilgisayar için süreçlerin çıktısını ızgara görünümüne alın

Bu örnek, Server01 bilgisayarında çalışan işlemleri bir ızgara görünümü penceresinde görüntüler.

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

Örnek, Out-GridView cmdlet'inin takma adı olan ogv'yi kullanıyor. Başlık parametresi pencere başlığını belirtir.

Örnek 6: Uzak bilgisayarlardan tablo görünümüne veri çıkışı

Bu örnek, uzak bilgisayarlardan toplanan verilerin Out-GridView'a nasıl gönderileceğini gösterir.

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command, Get-Culture'u üç uzak bilgisayarda çalıştırır. Ortaya çıkan veriler Out-GridView'a aktarılır. Uzak bilgisayarda çalışan komut dosyası bloğunun Out-GridView komutunu içermediğine dikkat edin. Böyle olsaydı, uzaktaki bilgisayarların her birinde bir ızgara görünümü penceresi açmaya çalıştığında komut başarısız olurdu.

Örnek 7: Birden fazla öğeyi "Out-GridView" aracılığıyla iletin

Bu örnek, Out-GridView penceresinden birden fazla işlem seçmenizi sağlar. Seçtiğiniz işlemler Export-Csv komutuna aktarılır ve ProcessLog.csv dosyasına yazılır.

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Out-GridView'un PassThru parametresi, ardışık düzende birden fazla öğe göndermenize olanak tanır. PassThru parametresi, OutputMode parametresinin Multiple değerinin kullanılmasına eşdeğerdir.

Örnek 8: "Out-GridView" için bir Windows kısayolu oluşturun

Bu örnek, Out-GridView penceresine bir Windows kısayolu oluşturmak için Out-GridView'un Wait parametresinin nasıl kullanılacağını gösterir.

pwsh -Command "Get-Service | Out-GridView -Wait"

Bu komut satırı bir Windows kısayolunda kullanılabilir. Wait parametresi olmadan, PowerShell Out-GridView penceresi açılır açılmaz çıkar ve bu da Out-GridView penceresini neredeyse anında kapatır.

Parametreler

-InputObject

Cmdlet'in Out-GridView için giriş olarak kabul ettiği nesneyi belirtir.

Bir nesne koleksiyonunu Out-GridView'e göndermek için InputObject parametresini kullandığınızda, Out-GridView, koleksiyonu tek bir koleksiyon nesnesi olarak ele alır ve koleksiyonu temsil eden bir satırı görüntüler. Koleksiyondaki her nesneyi görüntülemek için, nesneleri Out-GridView'a göndermek üzere bir ardışık düzen operatörü (|) kullanın.

Tip :

PSObject

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-OutputMode

Etkileşimli pencerenin işlem hattından diğer komutlara girdi olarak gönderdiği öğeleri belirtir. Varsayılan olarak bu cmdlet herhangi bir çıktı oluşturmaz. Etkileşimli pencereden öğeleri ardışık düzene 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.

• Yok. Öğe yok. Bu varsayılan değerdir.
• Tek. Sıfır öğe veya bir öğe. Bir sonraki komut yalnızca bir giriş nesnesi alabildiğinde bu değeri kullanın.
• Birden çok. Sıfır, bir veya daha fazla öğe. Bir sonraki komut birden fazla giriş nesnesi alabildiğinde bu değeri kullanın. Bu değer Geçit parametresine eşdeğerdir.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :

Çıkış Modu Seçeneği

Kabul edilen değerler:

Yok, Tek, Çoklu

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PassThru

Cmdlet'in etkileşimli penceredeki öğeleri diğer komutlara girdi olarak ardışık düzen boyunca gönderdiğini belirtir. Varsayılan olarak bu cmdlet herhangi bir çıktı oluşturmaz. Bu parametre, OutputMode parametresinin Multiple değerinin kullanılmasına eşdeğerdir.

Etkileşimli pencereden öğeleri ardışık düzene göndermek için, öğeleri seçmek için tıklayın ve ardından Tamam'a tıklayın. Shift-tıklama ve Ctrl-tıklama desteklenir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Title

Out-GridView penceresinin başlık çubuğunda görünen metni belirtir. Varsayılan olarak başlık çubuğu Out-GridView'u çağıran komutu görüntüler.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Wait

Cmdlet'in komut istemini bastırdığını ve Out-GridView penceresi kapatılıncaya kadar Windows PowerShell'in kapanmasını engellediğini belirtir. Varsayılan olarak, Out-GridView penceresi açıldığında komut istemi geri döner.

Bu özellik, Windows kısayollarında Out-GridView cmdlet'lerini kullanmanızı sağlar. Wait parametresi olmadan bir kısayolda Out-GridView kullanıldığında, Out-GridView penceresi PowerShell kapanmadan yalnızca kısa bir süre önce görünür.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

PSObject

Bu cmdlet'e herhangi bir nesneyi aktarabilirsiniz.

Çıkışlar

Yok

Varsayılan olarak bu cmdlet hiçbir çıktı döndürmez.

PSObject

PassThru parametresini kullandığınızda bu cmdlet, seçilen satırları temsil eden nesneleri döndürür.

Notlar

PowerShell, Out-GridView için aşağıdaki takma adları iç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 ızgara görünümü penceresi açmak için uzaktan komut kullanamazsınız.

Out-GridView'e gönderdiğiniz komut çıktısı, Format-Table veya Format- gibi Format cmdlet'leri kullanılarak biçimlendirilemez. Geniş cmdlet'ler. Özellikleri seçmek için Select-Object cmdlet'ini kullanın.

Uzak komutlardan seri durumdan çıkarılan çıktı, ızgara görünümü penceresinde doğru şekilde biçimlendirilmeyebilir.

Out-GridView için Klavye Kısayolları

Tab

İmleci Filtre kutusundan Ölçüt ekle menüsüne, tabloya ve tabloya geri taşır.

UpArrow

Bir satır yukarı çıkın. Verilerin ilk satırından sütun başlıklarına gider.

DownArrow

Bir satır aşağı gidin.

LeftArrow

Sütun başlığı satırında bir sütun sola git.

RightArrow

Sütun başlığı satırında bir sütun sağa gidin.

ContextMenuKey

Sütun başlığı satırında Sütunları Seç seçeneği görüntülenir.

Enter or Spacebar

Sütun başlığı satırında, sütun verilerini sıralayın (A-Z, Z-A arasında geçiş yapın).

Izgara Görünümü Penceresi Özellikleri Nasıl Kullanılır

Bir sütunu gizlemek veya göstermek için:

1. Herhangi bir sütun başlığını sağ tıklayın ve Sütunları Seç'i tıklayın.
2. Sütunları Seç iletişim kutusunda, sütunları Seçili sütunlar arasındaki Kullanılabilir sütunlar kutularına taşımak için ok tuşlarını kullanın. Izgara görünümü penceresinde yalnızca Sütunları Seç kutusundaki sütunlar görünür.

Sütunları yeniden sıralamak için:

Sütunları istediğiniz konuma sürükleyip bırakabilirsiniz. Veya aşağıdaki adımları kullanın:

1. Herhangi bir sütun başlığını sağ tıklayın ve Sütunları Seç'i tıklayın.
2. 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, ızgara görünümü penceresinde listenin altındaki sütunların solunda görünür.

Tablo Verileri Nasıl Sıralanır

• Verileri sıralamak için bir sütun başlığını tıklayın.
• Sıralama düzenini değiştirmek için sütun başlığına tekrar tıklayın. Aynı başlığı her tıklattığınızda, sıralama düzeni artandan azalan sıraya doğru geçiş yapar. Geçerli sıra, sütun başlığındaki bir üçgenle gösterilir.

Tablo Verileri Nasıl Seçilir

• Bir 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 (başlık satırı hariç) CTRL+A tuşlarına 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.
• Ardışık olmayan 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 başlığı satırının tamamını seçemezsiniz.

Satırlar Nasıl Kopyalanır

• Tablodan bir veya daha fazla satırı kopyalamak için satırları seçin ve ardından 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 başlığı satırını kopyalayamazsınız.

Tabloda Nasıl Arama Yapılır (Hızlı Filtre)

Tablodaki verileri aramak için Filtre kutusunu kullanın. Kutuya yazdığınızda tabloda yalnızca yazdığınız metni içeren öğeler görünür.

• Metin arayın. Tabloda metin aramak için Filtre kutusuna bulunacak metni yazın.

• Birden fazla kelime arayın. Tabloda birden fazla kelime aramak için kelimeleri boşluklarla ayırarak yazın. Out-GridView tüm kelimeleri (mantıksal VE) içeren satırları görüntüler.

• Gerçek ifadeleri arayın. Boşluk veya özel karakterler içeren ifadeleri aramak için ifadeyi tırnak içine alın. Out-GridView, ifadeyle tam eşleşmeyi içeren satırları görüntüler.

• Sütunlarda arama yapın. Bir veya daha fazla sütunda metin aramak için aşağıdaki biçimi kullanın:

  <column>:<text> [<column>:<text>] ...

  Örneğin, GörünenAd sütununda "Net"i bulmak için Filtre kutusuna şunu yazın:

  displayname:net

  DisplayName ve Ad sütunlarında "Net" bulunan satırları bulmak için Filtre kutusuna şunu yazın:

  displayname:net name:net

• Aramayı kapatın. Tablonun tamamını tekrar görüntülemek için Filtre kutusunun sağ üst köşesindeki kırmızı X düğmesini tıklayın veya Filtre kutusundaki metni silin.

Tabloyu Filtrelemek için Kriterleri Kullanın

Tabloda hangi öğelerin görüntüleneceğini belirlemek için kuralları veya kriterleri kullanabilirsiniz. Öğeler yalnızca sizin belirlediğiniz tüm ölçütleri karşıladıklarında görünür. Kullanılabilir ölçütler, ızgara görünümü penceresinde görüntülenen nesnelerin özelliklerine ve bu özelliklerin .NET Framework türlerine göre belirlenir.

Her kriter aşağıdaki formata sahiptir:

<column> <operator> <value>

Farklı özelliklere ilişkin ölçütler VE ile bağlanır. Aynı özelliğe ilişkin kriterler VEYA ile bağlanır. Mantıksal bağlayıcıları değiştiremezsiniz.

Kriterler yalnızca ekranı etkiler. Tablodaki öğeleri silmez.

Kriter Nasıl Eklenir?

1. Kriter ekle menü düğmesini görüntülemek için pencerenin sağ üst köşesinde Genişlet okunu tıklayın.
2. Kriter Ekle menü düğmesini tıklayın.
3. Sütunları (özellikler) seçmek için tıklayın. Bir veya daha fazla özellik seçebilirsiniz.
4. Özellikleri seçmeyi tamamladığınızda Ekle düğmesini tıklayın.
5. Eklemeleri iptal etmek için İptal'i tıklayın.
6. Daha fazla ölçüt eklemek için Kriter Ekle düğmesini tekrar tıklayın.

Kriter Nasıl Düzenlenir

• Bir operatörü değiştirmek için mavi operatör değerine tıklayın ve ardından açılır listeden farklı bir operatör seçin.
• Bir 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ünür. Kaldırmak için değeri değiştirin.
• OR ifadesi oluşturmak için aynı özelliğe sahip bir ölçüt ekleyin.

Kriterler Nasıl Silinir?

• Seçilen kriterleri silmek için her kriterin yanındaki kırmızı X işaretine tıklayın.
• Tüm kriterleri silmek için Tümünü Temizle düğmesini tıklayın.