Bagikan melalui

Import-PowerShellDataFile

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mengimpor nilai dari .PSD1 file tanpa memanggil isinya.

Sintaks

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

Deskripsi

Import-PowerShellDataFile Cmdlet dengan aman mengimpor pasangan kunci-nilai dari hashtable yang ditentukan dalam .PSD1 file. Nilai dapat diimpor menggunakan Invoke-Expression pada konten file. Namun, Invoke-Expression menjalankan kode apa pun yang terkandung dalam file. Ini dapat menghasilkan hasil yang tidak diinginkan atau menjalankan kode yang tidak aman. Import-PowerShellDataFile mengimpor data tanpa memanggil kode. Secara default ada batas kunci 500, tetapi ini dapat dilewati dengan sakelar SkipLimitCheck .

Contoh

Contoh 1: Mengambil nilai dari PSD1

Contoh ini mengambil pasangan kunci-nilai yang disimpan dalam hashtable yang disimpan di dalam Configuration.psd1 file. Get-Content digunakan untuk menampilkan isi Configuration.psd1 file.

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

Parameter

-LiteralPath

Jalur ke file yang sedang diimpor. Semua karakter dalam jalur diperlakukan sebagai nilai harfiah. Karakter kartubebas tidak diproses.

Jenis:String[]
Alias:PSPath, LP
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Path

Jalur ke file yang sedang diimpor. Kartubebas diizinkan tetapi hanya file pencocokan pertama yang diimpor.

Jenis:String[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:True

-SkipLimitCheck

Secara default Import-PowerShellDataFile hanya mengimpor 500 kunci dari .psd1 file. Gunakan SkipLimitCheck untuk mengimpor lebih dari 500 kunci.

Jenis:Switch
Position:0
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Output

Hashtable

Cmdlet ini mengembalikan data dari file sebagai tabel hash.