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: