Bagikan melalui

Import-PowerShellDataFile

Modul:
Microsoft.PowerShell.Utility Module

Mengimpor nilai dari file .psd1 tanpa memanggil isinya.

Sintaks

ByPath (Default) 

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

ByLiteralPath 

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.

Properti parameter

Jenis:

String[]

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

Set parameter

ByLiteralPath
Position:0
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

Set parameter

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

-SkipLimitCheck

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

Properti parameter

Jenis:Switch
Nilai default:False
Mendukung wildcard:False
DontShow:False

Set parameter

All
Position:0
Wajib:False
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.