Udostępnij za pośrednictwem

Export-CrescendoModule

  • Odwołanie
Moduł:
Microsoft.PowerShell.Crescendo

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

Składnia

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.

Typ:String[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ModuleName

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

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NoClobberManifest

Zapobiega zastępowaniu manifestu modułu.

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

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: