Get-Item

Başvuru

Modül:: Microsoft.PowerShell.Management

Öğeyi belirtilen konumda alır.

Sözdizimi

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-Stream <string[]>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-Stream <string[]>]
   [<CommonParameters>]

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<CommonParameters>]

Description

Get-Item cmdlet'i, belirtilen konumdaki öğeyi getirir. Joker karakter (*) kullanılarak öğenin tüm içeriği istenmediği sürece, belirtilen konumdaki öğenin içeriği alınmaz.

Bu cmdlet, PowerShell sağlayıcıları tarafından farklı veri deposu türleri arasında gezinmek için kullanılır.

Örnekler

Örnek 1: Geçerli dizini alma

Bu örnek geçerli dizini alır. Nokta ('.'), öğeyi geçerli konumda (içeriğinde değil) temsil eder.

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Örnek 2: Geçerli dizindeki tüm öğeleri alma

Bu örnek geçerli dizindeki tüm öğeleri alır. Joker karakter (*), geçerli öğenin tüm içeriğini temsil eder.

Get-Item *

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006   9:29 AM            Logs
d----         7/26/2006   9:26 AM            Recs
-a---         7/26/2006   9:28 AM         80 date.csv
-a---         7/26/2006  10:01 AM         30 filenoext
-a---         7/26/2006   9:30 AM      11472 process.doc
-a---         7/14/2006  10:47 AM         30 test.txt

Örnek 3: Bir sürücünün geçerli dizinini alma

Bu örnek, C: sürücüsünün geçerli dizinini alır. Alınan nesne, içeriğini değil yalnızca dizini temsil eder.

Get-Item C:

Örnek 4: Belirtilen sürücüdeki öğeleri alma

Bu örnek, C: sürücüsündeki öğeleri alır. Joker karakter (*) yalnızca kapsayıcıyı değil kapsayıcıdaki tüm öğeleri temsil eder.

Get-Item C:\*

PowerShell'de, içeriği almak için geleneksel *yerine tek bir yıldız işareti (*.*) kullanın. Biçim tam anlamıyla yorumlanır, bu nedenle *.* nokta olmadan dizinleri veya dosya adlarını alamaz.

Örnek 5: Belirtilen dizindeki özelliği edin

Bu örnek, dizininin C:\Windows özelliğini alır. LastAccessTime, dosya sistemi dizinlerinin yalnızca bir özelliğidir. Dizinin tüm özelliklerini görmek için (Get-Item <directory-name>) | Get-Memberyazın.

(Get-Item C:\Windows).LastAccessTime

Örnek 6: Kayıt defteri anahtarının içeriğini gösterme

Bu örnekte Microsoft.PowerShell kayıt defteri anahtarının içeriği gösterilmektedir. Kayıt defteri anahtarlarını ve alt anahtarları almak için bu cmdlet'i PowerShell Kayıt Defteri sağlayıcısıyla kullanabilirsiniz, ancak kayıt defteri değerlerini ve verilerini almak için Get-ItemProperty cmdlet'ini kullanmanız gerekir.

Get-Item HKLM:\Software\Microsoft\PowerShell\1\Shellids\Microsoft.PowerShell\

Örnek 7: Dizinde dışlama içeren öğeleri alma

Bu örnek, Windows dizininde nokta (.) içeren ancak w*ile başlamamış adlara sahip öğeleri alır. Bu örnek yalnızca yol, öğenin içeriğini belirtmek için bir joker karakter (*) içerdiğinde çalışır.

Get-Item C:\Windows\*.* -Exclude "w*"

Örnek 8: Sabit bağlantı bilgilerini alma

PowerShell 6.2'de, sabit bağlantı bilgilerini almak için alternatif bir görünüm eklendi. Sabit bağlantı bilgilerini almak için çıkışı Format-Table -View childrenWithHardlink'a yönlendirin.

Get-Item C:\Windows\System32\ntoskrnl.exe |
    Format-Table -View childrenWithHardLink

Directory: C:\Windows\System32

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
la---           5/12/2021  7:40 AM       10848576 ntoskrnl.exe

Mode özelliği, l'de la--- tarafından sabit bağlantıyı tanımlar.

Örnek 9: Windows Dışı İşletim Sistemleri için Çıkış

Unix sistemlerinde PowerShell 7.1'de, Get-Item cmdlet'i Unix benzeri bir çıkış sağlar:

PS> Get-Item /Users

Directory: /

UnixMode    User  Group   LastWriteTime      Size  Name
--------    ----  -----   -------------      ----  ----
drwxr-xr-x  root  admin   12/20/2019 11:46   192   Users

Artık çıkışın parçası olan yeni özellikler şunlardır:

UnixMode, unix sisteminde gösterildiği gibi dosya izinleridir
Kullanıcı dosya sahibidir
Grup grup sahibi
Boyut, bir Unix sisteminde gösterildiği gibi dosya veya dizinin boyutudur

Not

Bu özellik PowerShell 7.1'de deneyselden temele taşındı.

Parametreler

-CodeSigningCert

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre ve Sertifika sağlayıcısı yalnızca Windows'ta kullanılabilir.

Code Signing özellik değerinde olan sertifikaları almak için CodeSigningCert parametresini kullanın.

Daha fazla bilgi için bkz. about_Certificate_Provider.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Credential

Not

Bu parametre, PowerShell ile yüklenen sağlayıcılar tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.

Tür:	PSCredential
Position:	Named
Default value:	Current user
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-DnsName

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre ve Sertifika sağlayıcısı yalnızca Windows'ta kullanılabilir.

Cmdlet'in aldığı sertifikaların DNSNameList özelliğiyle eşleşecek bir etki alanı adı veya ad deseni belirtir. Bu parametrenin değeri Unicode veya ASCIIolabilir. Punycode değerleri Unicode'a dönüştürülür. Joker karakterlere (*) izin verilir.

Bu parametre PowerShell 7.1'de yeniden tanıtıldı

Daha fazla bilgi için bkz. about_Certificate_Provider.

Tür:	DnsNameRepresentation
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-DocumentEncryptionCert

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre ve Sertifika sağlayıcısı yalnızca Windows'ta kullanılabilir.

Document Encryption özellik değerinde olan sertifikaları almak için DocumentEncryptionCert parametresini kullanın.

Daha fazla bilgi için bkz. about_Certificate_Provider.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Eku

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre ve Sertifika sağlayıcısı yalnızca Windows'ta kullanılabilir.

Cmdlet'in aldığı sertifikaların EnhancedKeyUsageList özelliğiyle eşleşecek metni veya metin desenini belirtir. Joker karakterlere (*) izin verilir. EnhancedKeyUsageList özelliği, EKU'nun kolay adını ve OID alanlarını içerir.

Bu parametre PowerShell 7.1'de yeniden tanıtıldı

Daha fazla bilgi için bkz. about_Certificate_Provider.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter C:\Windows dizininin içeriğini belirtir.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-ExpiringInDays

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre ve Sertifika sağlayıcısı yalnızca Windows'ta kullanılabilir.

Cmdlet'in yalnızca belirtilen sayıda gün içinde veya daha önce süresi dolan sertifikaları döndürmesi gerektiğini belirtir. Sıfır (0) değeri süresi dolmuş sertifikaları alır.

Bu parametre PowerShell 7.1'de yeniden tanıtıldı

Daha fazla bilgi için bkz. about_Certificate_Provider.

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Filter

Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtreleri destekleyen tek yüklü PowerShell sağlayıcısıdır. Filtreler diğer parametrelerden daha verimlidir. Sağlayıcı, cmdlet nesneleri alırken nesneleri filtreler, böylece PowerShell nesneleri aldıktan sonra filtreleme yapmaz. Filtre dizesi dosyaları listelemek için .NET API'sine geçirilir. API yalnızca * ve ? joker karakterlerini destekler.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-Force

Bu cmdlet'in gizli öğeler gibi başka türlü erişilmeyecek öğeleri aldığını gösterir. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz. about_Providers. cmdletForce parametresini kullanarak bile güvenlik kısıtlamalarını geçersiz kılamaz.

Tür:	SwitchParameter
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows dizininin içeriğini belirttiğinde etkilidir.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-LiteralPath

Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleri içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Daha fazla bilgi için bkz. about_Quoting_Rules.

Tür:	String[]
Diğer adlar:	PSPath, LP
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Path

Bir öğenin yolunu belirtir. Bu cmdlet öğeyi belirtilen konumda alır. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak parametre adı Yol isteğe bağlıdır.

Geçerli konumu belirtmek için nokta (.) kullanın. Geçerli konumdaki tüm öğeleri belirtmek için joker karakteri (*) kullanın.

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	True

-SSLServerAuthentication

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre ve Sertifika sağlayıcısı yalnızca Windows'ta kullanılabilir.

Server Authentication özellik değerinde olan sertifikaları almak için SSLServerAuthentication parametresini kullanın.

Daha fazla bilgi için bkz. about_Certificate_Provider.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Stream

Bu, FileSystem sağlayıcısı tarafından sağlanan dinamik bir parametredir. Bu parametre yalnızca Windows'ta kullanılabilir.

Belirtilen alternatif veri akışını dosyadan alır. Akış adını girin. Joker karakterler desteklenir. Tüm akışları almak için yıldız işareti (*) kullanın. Bu parametre dizinlerde geçerlidir, ancak dizinlerde varsayılan olarak veri akışları olmadığını unutmayın.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur. PowerShell 7.2'den itibaren Get-Item hem dizinlerden hem de dosyalardan alternatif veri akışları alabilir.

Daha fazla bilgi için bkz. about_FileSystem_Provider.

Tür:	String[]
Position:	Named
Default value:	No alternate file streams
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

Girişler

String

Bu cmdlet'e yol içeren bir dizeyi yönlendirebilirsiniz.

Çıkışlar

AliasInfo

Cmdlet, Alias: sürücüsüne erişirken bu türden bir çıktı üretir.

X509StoreLocation

X509Store

X509Certificate2

Cmdlet, Cert: sürücüsüne erişirken bu türleri verir.

DictionaryEntry

Cmdlet, Env: sürücüsüne erişirken bu türden bir çıktı üretir.

DirectoryInfo

FileInfo

Cmdlet, FileSystem sürücülerine erişirken bu türlerin çıkışını oluşturur.

FunctionInfo

FilterInfo

cmdlet, Function: sürücülerine erişirken bu türlerin çıktısını verir.

RegistryKey

Cmdlet, Kayıt Defteri sürücülerine erişirken bu tür bir çıkış üretir.

PSVariable

cmdlet, Variable: sürücülerine erişirken bu tür çıkışlar yapar.

WSManConfigContainerElement

WSManConfigLeafElement

cmdlet, WSMan: sürücülerine erişirken bu türlerin çıktısını verir.

Notlar

PowerShell, Get-Itemiçin aşağıdaki diğer adları içerir:

Tüm platformlar:
- gi

Bu cmdlet'in Yineleme parametresi yoktur, çünkü yalnızca bir öğe alır, içeriği almaz. Bir öğenin içeriğini özyinelemeli olarak almak için Get-ChildItemkullanın.

Kayıt defterinde gezinmek için bu cmdlet'i kullanarak kayıt defteri anahtarlarını alın ve Get-ItemProperty kullanarak kayıt defteri değerlerini ve verilerini alın. Kayıt defteri değerleri, kayıt defteri anahtarının özellikleri olarak kabul edilir.

Bu cmdlet, herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.

Aracılığıyla paylaş

Get-Item

Sözdizimi

Description

Örnekler

Örnek 1: Geçerli dizini alma

Örnek 2: Geçerli dizindeki tüm öğeleri alma

Örnek 3: Bir sürücünün geçerli dizinini alma

Örnek 4: Belirtilen sürücüdeki öğeleri alma

Örnek 5: Belirtilen dizindeki özelliği edin

Örnek 6: Kayıt defteri anahtarının içeriğini gösterme

Örnek 7: Dizinde dışlama içeren öğeleri alma

Örnek 8: Sabit bağlantı bilgilerini alma

Örnek 9: Windows Dışı İşletim Sistemleri için Çıkış

Parametreler

-CodeSigningCert

-Credential

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-Filter

-Force

-Include

-LiteralPath

-Path

-SSLServerAuthentication

-Stream

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar