Import-PowerShellDataFile

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

İçeriğini çağırmadan bir .PSD1 dosyadan değerleri içeri aktarır.

Syntax

Import-PowerShellDataFile
      [-Path] <String[]>
      [-SkipLimitCheck]
      [<CommonParameters>]
Import-PowerShellDataFile
      [-LiteralPath] <String[]>
      [-SkipLimitCheck]
      [<CommonParameters>]

Description

Cmdlet, Import-PowerShellDataFile bir dosyada tanımlanan karma tablolardan anahtar-değer çiftlerini güvenli bir .PSD1 şekilde içeri aktarır. Değerler, dosyanın içeriği kullanılarak içeri aktarılabilir Invoke-Expression . Ancak, Invoke-Expression dosyasındaki tüm kodları çalıştırır. Bu, istenmeyen sonuçlara neden olabilir veya güvenli olmayan kod yürütebilir. Import-PowerShellDataFile kodu çağırmadan verileri içeri aktarır. Varsayılan olarak 500 anahtar sınırı vardır, ancak SkipLimitCheck anahtarıyla bu atlanabilir.

Örnekler

Örnek 1: PSD1'den değerleri alma

Bu örnek, dosyanın içinde tutulan karma tablo içinde depolanan anahtar-değer çiftlerini Configuration.psd1 alır. Get-Content dosyanın içeriğini Configuration.psd1 göstermek için kullanılır.

Get-Content .\Configuration.psd1
$config = Import-PowerShellDataFile .\Configuration.psd1
$config.AllNodes

@{
    AllNodes = @(
        @{
            NodeName = 'DSC-01'
        }
        @{
            NodeName = 'DSC-02'
        }
    )
}

Name                           Value
----                           -----
NodeName                       DSC-01
NodeName                       DSC-02

Parametreler

-LiteralPath

İçeri aktarılan dosyanın yolu. Yoldaki tüm karakterler değişmez değer olarak değerlendirilir. Joker karakterler işlenmez.

Type:String[]
Aliases:PSPath, LP
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

İçeri aktarılan dosyanın yolu. Joker karakterlere izin verilir, ancak yalnızca ilk eşleşen dosya içeri aktarılır.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-SkipLimitCheck

Varsayılan olarak Import-PowerShellDataFile bir .psd1 dosyadan yalnızca 500 anahtar içeri aktarır. 500'den fazla anahtarı içeri aktarmak için SkipLimitCheck kullanın.

Type:Switch
Position:0
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Çıkışlar

Hashtable

Bu cmdlet, dosyadaki verileri karma tablo olarak döndürür.