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.

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

Kumpulan 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

Kumpulan 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 dibatasi hingga 500 kunci yang berisi maksimum 5000 simpul AST saat mengimpor dari .psd1 file. Gunakan SkipLimitCheck untuk melewati batas ini.

Important

Anda hanya boleh melewati batas jika Anda yakin file aman untuk diimpor. Dimungkinkan bagi aktor jahat untuk membuat .psd1 file dengan sejumlah besar kunci atau simpul AST yang dapat mengakibatkan penolakan layanan.

Properti parameter

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

Kumpulan 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.