Udostępnij przez


Export-CrescendoModule

Tworzy moduł z plików konfiguracji JSON programu PowerShell Crescendo

Składnia

Default (Domyślna)

Export-CrescendoModule
    [-ConfigurationFile] <String[]>
    [-ModuleName] <String>
    [-Force]
    [-NoClobberManifest]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

To polecenie cmdlet eksportuje obiekt, który można przekonwertować na funkcję, która działa jako serwer proxy dla określonego polecenia platformy. Wynikowy plik modułu powinien być wykonywalny w wersji 5.1 programu PowerShell.

Polecenie cmdlet tworzy zarówno .psm1 modułu, jak i pliki manifestu modułu .psd1. Może to powodować problemy, gdy manifest modułu został dostosowany poza zakresem crescendo. Użyj parametru NoClobberManifest, aby zapobiec zastępowaniu manifestu.

Przykłady

PRZYKŁAD 1

Export-CrescendoModule -ModuleName netsh -ConfigurationFile netsh*.json
Import-Module ./netsh.psm1

PRZYKŁAD 2

Export-CrescendoModule netsh netsh*.json -force

Parametry

-ConfigurationFile

Jest to lista plików JSON reprezentujących serwery proxy dla modułu.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Force

Jeśli domyślnie Export-CrescendoModule nie zastępuje istniejącego modułu. Użyj parametru Force, aby zastąpić istniejący plik lub usunąć go przed uruchomieniem Export-CrescendoModule.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ModuleName

Nazwa pliku modułu, który chcesz utworzyć. Możesz pominąć końcowy .psm1.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-NoClobberManifest

Zapobiega zastępowaniu manifestu modułu.

Należy ręcznie zaktualizować manifest przy użyciu nowych poleceń cmdlet i ustawień.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PassThru

Emituj obiekt ze ścieżką do pliku psm1 i argumentami new-ModuleManifest.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Dane wyjściowe

Object

Uwagi

Wewnętrznie ta funkcja wywołuje polecenie cmdlet Import-CommandConfiguration, które zwraca obiekt polecenia. Wszystkie pliki podane w parametrze ConfigurationFile są następnie używane do tworzenia poszczególnych funkcji. Na koniec wszystkie serwery proxy są używane do tworzenia wywołania polecenia Export-ModuleMember, więc po zaimportowaniu wynikowego modułu moduł zawiera wszystkie dostępne serwery proxy poleceń.

Export-CrescendoModule dodaje tag CrescendoBuilt do manifestu modułu. Ten tag służy do znajdowania modułów w galerii programu PowerShell utworzonych przy użyciu narzędzia Crescendo. Aby uzyskać więcej informacji, zobacz: