about_Properties
Kısa açıklama
PowerShell'de nesne özelliklerinin nasıl kullanılacağını açıklar.
Uzun açıklama
PowerShell, veri depolarındaki öğeleri veya bilgisayarın durumunu göstermek için nesneler olarak adlandırılan yapılandırılmış bilgi koleksiyonlarını kullanır. Genellikle, Microsoft .NET Framework'ün parçası olan nesnelerle çalışırsınız, ancak PowerShell'de özel nesneler de oluşturabilirsiniz.
Bir öğe ile nesnesi arasındaki ilişki çok yakın. Bir nesneyi değiştirdiğinizde, genellikle temsil ettiği öğeyi değiştirirsiniz. Örneğin, PowerShell'de bir dosya aldığınızda gerçek dosyayı alamazsınız. Bunun yerine, dosyayı temsil eden bir FileInfo nesnesi alırsınız. FileInfo nesnesini değiştirdiğinizde, dosya da değişir.
Çoğu nesnenin özellikleri vardır. Özellikler, bir nesneyle ilişkili verilerdir. Farklı nesne türleri farklı özelliklere sahiptir. Örneğin, bir dosyayı temsil eden FileInfo nesnesinin, dosyanın salt okunur özniteliğine sahip olup olmadığını ve $False yoksa içeren $True bir IsReadOnly özelliği vardır. Bir dosya sistemi dizinini temsil eden DirectoryInfo nesnesinin üst dizinin yolunu içeren bir Parent özelliği vardır.
Nesne özellikleri
Bir nesnenin özelliklerini almak için cmdlet'ini Get-Member kullanın. Örneğin, bir FileInfo nesnesinin özelliklerini almak için cmdlet'ini Get-ChildItem kullanarak bir dosyayı temsil eden FileInfo nesnesini alın. Ardından FileInfo nesnesini Get-Memberadresine göndermek için işlem hattı işlecini (|) kullanın. Aşağıdaki komut dosyayı alır pwsh.exe ve adresine Get-Membergönderir. Otomatik $PSHOME değişken, PowerShell yükleme dizininin yolunu içerir.
Get-ChildItem $PSHOME\pwsh.exe | Get-Member
Komutun çıktısı FileInfo nesnesinin üyelerini listeler. Üyeler hem özellikleri hem de yöntemleri içerir. PowerShell'de çalışırken, nesnelerin tüm üyelerine erişebilirsiniz.
Yöntemlerin değil, yalnızca bir nesnenin özelliklerini almak için, aşağıdaki örnekte gösterildiği gibi cmdlet'in Get-Member MemberType parametresini değeriyle Propertykullanın.
Get-ChildItem $PSHOME\pwsh.exe | Get-Member -MemberType Property
TypeName: System.IO.FileInfo
Name MemberType Definition
---- ---------- ----------
Attributes Property System.IO.FileAttributes Attributes {get;set;}
CreationTime Property System.DateTime CreationTime {get;set;}
CreationTimeUtc Property System.DateTime CreationTimeUtc {get;set;}
Directory Property System.IO.DirectoryInfo Directory {get;}
DirectoryName Property System.String DirectoryName {get;}
Exists Property System.Boolean Exists {get;}
Extension Property System.String Extension {get;}
FullName Property System.String FullName {get;}
IsReadOnly Property System.Boolean IsReadOnly {get;set;}
LastAccessTime Property System.DateTime LastAccessTime {get;set;}
LastAccessTimeUtc Property System.DateTime LastAccessTimeUtc {get;set;}
LastWriteTime Property System.DateTime LastWriteTime {get;set;}
LastWriteTimeUtc Property System.DateTime LastWriteTimeUtc {get;set;}
Length Property System.Int64 Length {get;}
Name Property System.String Name {get;}
Özellikleri buldukktan sonra PowerShell komutlarınızda kullanabilirsiniz.
Özellik değerleri
Belirli bir türün her nesnesi aynı özelliklere sahip olsa da, bu özelliklerin değerleri belirli nesneyi açıklar. Örneğin, her FileInfo nesnesinin bir CreationTime özelliği vardır, ancak bu özelliğin değeri her dosya için farklılık gösterir.
Bir nesnenin özelliklerinin değerlerini almanın en yaygın yolu, üye erişim işlecini (. kullanmaktır). Nesneyi içeren bir değişken veya nesneyi alan bir komut gibi nesneye bir başvuru yazın. Ardından işlecini (.) ve ardından özellik adını yazın.
Örneğin, aşağıdaki komut dosyanın CreationTime özelliğinin pwsh.exe değerini görüntüler. komutu, Get-ChildItem öğesini temsil pwsh.exe fileeden bir FileInfo nesnesi döndürür. Komut, herhangi bir özelliğe erişilmeden önce yürütülmesini sağlamak için parantez içine alınır.
(Get-ChildItem $PSHOME\pwsh.exe).CreationTime
Tuesday, June 14, 2022 5:17:14 PM
Ayrıca, aşağıdaki örnekte gösterildiği gibi bir değişkene bir nesne kaydedebilir ve üye erişimi (.) yöntemini kullanarak özelliklerini alabilirsiniz:
$a = Get-ChildItem $PSHOME\pwsh.exe
$a.CreationTime
Tuesday, June 14, 2022 5:17:14 PM
Bir nesnenin Select-Object özellik değerlerini görüntülemek için ve Format-List cmdlet'lerini de kullanabilirsiniz. Select-Object ve Format-List her birinin bir Property parametresi vardır. Bir veya daha fazla özelliği ve bunların değerlerini belirtmek için Property parametresini kullanabilirsiniz. İsterseniz, tüm özellikleri temsil etmek için joker karakteri (*) de kullanabilirsiniz.
Örneğin, aşağıdaki komut pwsh.exe dosyasının tüm özelliklerinin değerlerini görüntüler.
Get-ChildItem $PSHOME\pwsh.exe | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7\pwsh.exe
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7
PSChildName : pwsh.exe
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
Mode : -a---
ModeWithoutHardLink : -a---
VersionInfo : File: C:\Program Files\PowerShell\7\pwsh.exe
InternalName: pwsh.dll
OriginalFilename: pwsh.dll
FileVersion: 7.3.9.500
FileDescription: pwsh
Product: PowerShell
ProductVersion: 7.3.9 SHA: 116d193ed28dcc6914653c799846bbf379cea0fb
Debug: False
Patched: False
PreRelease: False
PrivateBuild: False
SpecialBuild: False
Language: Language Neutral
BaseName : pwsh
ResolvedTarget : C:\Program Files\PowerShell\7\pwsh.exe
Target :
LinkType :
Length : 293312
DirectoryName : C:\Program Files\PowerShell\7
Directory : C:\Program Files\PowerShell\7
IsReadOnly : False
FullName : C:\Program Files\PowerShell\7\pwsh.exe
Extension : .exe
Name : pwsh.exe
Exists : True
CreationTime : 10/25/2023 7:00:18 PM
CreationTimeUtc : 10/26/2023 12:00:18 AM
LastAccessTime : 11/14/2023 5:14:36 PM
LastAccessTimeUtc : 11/14/2023 11:14:36 PM
LastWriteTime : 10/25/2023 7:00:18 PM
LastWriteTimeUtc : 10/26/2023 12:00:18 AM
LinkTarget :
UnixFileMode : -1
Attributes : Archive
Statik özellikler
PowerShell'de .NET sınıflarının statik özelliklerini kullanabilirsiniz. Statik özellikler, bir nesnenin özellikleri olan standart özelliklerden farklı olarak sınıfın özellikleridir.
Bir sınıfın statik özelliklerini almak için cmdlet'in Static parametresini Get-Member kullanın. Örneğin, aşağıdaki komut sınıfın statik özelliklerini System.DateTime alır.
Get-Date | Get-Member -MemberType Property -Static
TypeName: System.DateTime
Name MemberType Definition
---- ---------- ----------
MaxValue Property static datetime MaxValue {get;}
MinValue Property static datetime MinValue {get;}
Now Property datetime Now {get;}
Today Property datetime Today {get;}
UtcNow Property datetime UtcNow {get;}
Statik özelliğin değerini almak için aşağıdaki söz dizimini kullanın.
[<ClassName>]::<Property>
Örneğin, aşağıdaki komut sınıfının UtcNow statik özelliğinin System.DateTime değerini alır.
[System.DateTime]::UtcNow
Üye erişim sabit listesi
PowerShell 3.0'dan başlayarak, üye erişim işlecini (.) kullanarak liste koleksiyonunda olmayan bir özelliğe eriştiğinizde, PowerShell koleksiyondaki öğeleri otomatik olarak numaralandırır ve özelliğin değerini her öğede döndürür. Daha fazla bilgi için bkz . about_Member-Access_Enumeration.
Örnekler
Bu komut, döndüren her hizmetin DisplayName özelliğinin Get-Service değerini döndürür.
(Get-Service).DisplayName
Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...
Tüm koleksiyonlar, koleksiyondaki nesne sayısını döndüren bir Count özelliğine sahiptir.
(Get-Service).Count
176
PowerShell 3.0'dan başlayarak, koleksiyon olmayan tekil nesnelerin Count veya Length özelliğini alabilirsiniz.
(Get-Service Audiosrv).Count
1
Ancak bazı nesnelerin Length özelliği vardır. Örneğin, dizenin Uzunluğu dizedeki karakter sayısıdır. Count özelliği, nesnenin örnek sayısıdır.
PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1
Tek tek nesnelerde ve koleksiyonda bir özellik varsa, yalnızca koleksiyonun özelliği döndürülür.
$collection = @(
[pscustomobject]@{length = "foo"}
[pscustomobject]@{length = "bar"}
)
# PowerShell returns the collection's Length.
$collection.length
2
Ayrıca bkz.
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