Aracılığıyla paylaş

Out-String

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Giriş nesnelerini dize olarak verir.

Syntax

Out-String
   [-Width <Int32>]
   [-NoNewline]
   [-InputObject <PSObject>]
   [<CommonParameters>]
Out-String
   [-Stream]
   [-Width <Int32>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

cmdlet'i Out-String giriş nesnelerini dizelere dönüştürür. Varsayılan olarak, Out-String dizeleri biriktirir ve tek bir dize olarak döndürür, ancak Stream parametresini kullanarak bir kerede bir satır döndürmeyi veya dize dizisi oluşturmayı yönlendirebilirsinizOut-String. Bu cmdlet, nesne işleme daha az uygun olduğunda geleneksel kabuklarda yaptığınız gibi dize çıkışını aramanızı ve işlemenizi sağlar.

Örnekler

Örnek 1: Geçerli kültürü alma ve verileri dizelere dönüştürme

Bu örnek geçerli kullanıcının bölgesel ayarlarını alır ve nesne verilerini dizelere dönüştürür.

$C = Get-Culture | Select-Object -Property *
Out-String -InputObject $C -Width 100

Parent                         : en
LCID                           : 1033
KeyboardLayoutId               : 1033
Name                           : en-US
IetfLanguageTag                : en-US
DisplayName                    : English (United States)
NativeName                     : English (United States)
EnglishName                    : English (United States)
TwoLetterISOLanguageName       : en
ThreeLetterISOLanguageName     : eng
ThreeLetterWindowsLanguageName : ENU
CompareInfo                    : CompareInfo - en-US
TextInfo                       : TextInfo - en-US
IsNeutralCulture               : False
CultureTypes                   : SpecificCultures, InstalledWin32Cultures, FrameworkCultures
NumberFormat                   : System.Globalization.NumberFormatInfo
DateTimeFormat                 : System.Globalization.DateTimeFormatInfo
Calendar                       : System.Globalization.GregorianCalendar
OptionalCalendars              : {System.Globalization.GregorianCalendar,
                                 System.Globalization.GregorianCalendar}
UseUserOverride                : True
IsReadOnly                     : False

$C değişkeni bir Selected.System.Globalization.CultureInfo nesnesini depolar. nesnesi, işlem hattının Select-Objectaşağısına çıkış göndermenin Get-Culture sonucudur. Property parametresi, tüm özelliklerin nesnede yer alacağını belirtmek için bir yıldız işareti (*) joker karakteri kullanır.

Out-Stringdeğişkeninde depolanan CultureInfo nesnesini belirtmek için InputObject parametresini $C kullanır. içindeki $C nesneler dizeye dönüştürülür.

Not

Diziyi Out-String görüntülemek için çıkışı bir değişkene depolayın ve öğeleri görüntülemek için dizi dizinini kullanın. Dizi dizini hakkında daha fazla bilgi için bkz. about_Arrays.

$str = Out-String -InputObject $C -Width 100

Örnek 2: Nesnelerle çalışma

Bu örnekte nesnelerle çalışma ile dizelerle çalışma arasındaki fark gösterilmektedir. komutu, gcm metnini içeren bir diğer ad Get-Commandgörüntüler.

Get-Alias | Out-String -Stream | Select-String -Pattern "gcm"

Alias           gcm -> Get-Command

Get-Alias Her diğer ad için bir tane olan System.Management.Automation.AliasInfo nesnelerini alır ve nesneleri işlem hattına gönderir. Out-Stringtüm nesneleri tek bir dizede birleştirmek yerine her nesneyi bir dizeye dönüştürmek için Stream parametresini kullanır. System.String nesneleri işlem hattına gönderilir ve Select-String metin gcm eşleşmelerini bulmak için Pattern parametresini kullanır.

Not

Stream parametresini atlarsanız, döndüren tek dizedeki Out-String metin gcm'sini bulduğu için Select-String komut tüm diğer adları görüntüler.

Örnek 3: Kesilmesi önlemek için Width parametresini kullanın.

çıkışlarının Out-String çoğu bir sonraki satıra sarmalanmış olsa da, öğesine geçirilmeden Out-Stringönce çıktının biçimlendirme sistemi tarafından kesildiği senaryolar vardır. Width parametresini kullanarak kesilmesini önleyebilirsiniz.

PS> @{TestKey = ('x' * 200)} | Out-String
Name                           Value
----                           -----
TestKey                        xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx...

PS> @{TestKey = ('x' * 200)} | Out-String -Width 250

Name                           Value
----                           -----
TestKey                        xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Parametreler

-InputObject

Dizeye yazılacak nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NoNewline

PowerShell biçimlendiricisi tarafından oluşturulan çıkıştan tüm yeni çizgileri kaldırır. Dize nesnelerinin parçası olan yeni satırlar korunur.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Stream

Varsayılan olarak, Out-String boş üst bilgiler veya sondaki yeni satırlar da dahil olmak üzere konsolda gördüğünüz gibi biçimlendirilmiş tek bir dize çıkışı verir. Stream parametresi, her satırın birer birer çıkışını sağlarOut-String. Bunun tek özel durumu çok satırlı dizelerdir. Bu durumda, Out-String dizeyi yine de tek, çok satırlı bir dize olarak verir.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Width

Çıktının her satırındaki karakter sayısını belirtir. Kullanılan biçimlendirici cmdlet'ine bağlı olarak ek karakterler bir sonraki satıra kaydırılır veya kesilir. Width parametresi yalnızca biçimlendirilen nesnelere uygulanır. Bu parametreyi atlarsanız, genişlik konak programının özelliklerine göre belirlenir. Terminal (konsol) pencerelerinde, geçerli pencere genişliği varsayılan değer olarak kullanılır. PowerShell konsol pencereleri varsayılan olarak yüklemede 80 karakter genişliğindedir.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

PSObject

nesneleri işlem hattından adresine Out-Stringgönderebilirsiniz.

Çıkışlar

String

Out-String giriş nesnesinden oluşturduğu dizeyi döndürür.

Notlar

Fiili içeren Out cmdlet'ler nesneleri biçimlendirmez. Cmdlet'ler Out nesneleri belirtilen görüntüleme hedefi için biçimlendiriciye gönderir.