Out-GridView

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

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.

Ö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-GridView

Cmdlet'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-GridView

Get-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 $A Out-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-GridView

Invoke-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.csv

parametresi, 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

-OutputMode

-PassThru

-Title

-Wait

Girişler

PSObject

Herhangi bir nesneyi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSObject

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:

1. Herhangi bir sütun başlığına sağ tıklayın ve Sütunları Seç'e tıklayın.
2. 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:

1. Herhangi bir sütun başlığına sağ tıklayın ve Sütunları Seç'e 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, 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-GridView tü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-GridView tü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:net

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

  displayname:net name:net

• Aramayı 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

1. Ölçüt ekle menü düğmesini görüntülemek için pencerenin sağ üst köşesinde Genişlet okuna tıklayın.
2. Ölçüt Ekle menü düğmesine 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 bitirdiğinizde Ekle düğmesine tıklayın.
5. Eklemeleri iptal etmek için İptal'e tıklayın.
6. 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

• Out-File
• Out-Printer
• Out-String