Import-PowerShellDataFile

Modül:
Microsoft.PowerShell.Utility Module

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

Syntax

ByPath (Varsayılan) 

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.

Ö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 dosyadan içeri aktarılırken en fazla 5000 AST düğümü içeren 500 anahtarla sınırlıdır. Bu sınırları atlamak için SkipLimitCheck kullanın.

Important

Yalnızca dosyanın içeri aktarılabilmesi için güvenli olduğundan eminseniz sınırları atlamalısınız. Kötü amaçlı bir aktörün çok sayıda anahtara veya AST düğümüne sahip bir .psd1 dosya oluşturması hizmet reddine neden olabilir.

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.