Import-PowerShellDataFile

Referensi

Modul:: Microsoft.PowerShell.Utility

Mengimpor nilai dari file .psd1 tanpa memanggil isinya.

Sintaks

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

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

Deskripsi

cmdlet Import-PowerShellDataFile mengimpor pasangan kunci-nilai dengan aman dari hashtable yang ditentukan dalam file .psd1. 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 file Configuration.psd1. Get-Content digunakan untuk menampilkan konten file Configuration.psd1.

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 file .psd1. 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.

Bagikan melalui