Bagikan melalui

Import-PowerShellDataFile

Modul:
Microsoft.PowerShell.Utility Module

Mengimpor nilai dari file .psd1 tanpa memanggil isinya.

Sintaks

ByPath (Default) 

Import-PowerShellDataFile
    [[-Path] <string[]>]
    [<CommonParameters>]

ByLiteralPath 

Import-PowerShellDataFile
    [-LiteralPath <string[]>]
    [<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.

Nota

Anda hanya dapat mengimpor 500 pasangan kunci-nilai pertama.

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.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath, LP

Kumpulan parameter

ByLiteralPath
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Path

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

ByPath
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Output

Hashtable

Cmdlet ini mengembalikan data dari file sebagai tabel hash.