Aracılığıyla paylaş

Import-PowerShellDataFile

Modül:
Microsoft.PowerShell.Utility Module

bir .psd1 dosyasındaki değerleri içeriğini çağırmadan içeri aktarır.

Sözdizimi

ByPath EnterprisePublishing 

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

ByLiteralPath 

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

Description

Import-PowerShellDataFile cmdlet'i, bir .psd1 dosyasında tanımlanan karma tablolardan anahtar-değer çiftlerini güvenli bir şekilde içeri aktarır. Değerler, dosyanın içeriğinde Invoke-Expression kullanılarak içeri aktarılabilir. Ancak, Invoke-Expression dosyasındaki tüm kodları çalıştırır. Bu, istenmeyen sonuçlara neden olabilir veya güvenli olmayan kod yürütebilir. Import-PowerShellDataFile kodu çağırmadan verileri içeri aktarır. Varsayılan olarak 500 anahtar sınırı vardır, ancak bu SkipLimitCheck anahtarıyla atlanabilir.

Örnekler

Örnek 1: PSD1'den değerleri alma

Bu örnek, Configuration.psd1 dosyasının içinde tutulan karma tablodaki anahtar-değer çiftlerini alır. Get-Content, Configuration.psd1 dosyasının içeriğini göstermek için kullanılır.

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

Parametreler

-LiteralPath

İçeri aktarılan dosyanın yolu. Yoldaki tüm karakterler harfi harfine değer olarak değerlendirilir. Joker karakterler işlenmez.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:PSPath, LP

Parametre kümeleri

ByLiteralPath
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

İçeri aktarılan dosyanın yolu. Joker karakterlere izin verilir, ancak yalnızca ilk eşleşen dosya içeri aktarılır.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

ByPath
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-SkipLimitCheck

Varsayılan olarak Import-PowerShellDataFile bir .psd1 dosyasından yalnızca 500 anahtarı içeri aktarır. 500'den fazla anahtarı içeri aktarmak için SkipLimitCheck kullanın.

Parametre özellikleri

Tür:Switch
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

All
Position:0
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Çıkışlar

Hashtable

Bu cmdlet, dosyadaki verileri karma tablo olarak döndürür.