Freigeben über

Export-CrescendoModule

  • Referenz
Modul:
Microsoft.PowerShell.Crescendo

Erstellt ein Modul aus PowerShell Crescendo JSON-Konfigurationsdateien

Syntax

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

Beschreibung

Dieses Cmdlet exportiert ein Objekt, das in eine Funktion konvertiert werden kann, die als Proxy für einen plattformspezifischen Befehl fungiert. Die resultierende Moduldatei sollte bis Version 5.1 von PowerShell ausführbar sein.

Das Cmdlet erstellt sowohl die Modul .psm1 - als auch die Modulmanifestdateien .psd1 . Dies kann zu Problemen führen, wenn Sie das Modulmanifest über den Bereich von Crescendo hinaus angepasst haben. Verwenden Sie den NoClobberManifest-Parameter , um das Überschreiben des Manifests zu verhindern.

Beispiele

BEISPIEL 1

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

BEISPIEL 2

Export-CrescendoModule netsh netsh*.json -force

Parameter

-ConfigurationFile

Dies ist eine Liste von JSON-Dateien, die die Proxys für das Modul darstellen.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Standardmäßig, wenn Export-CrescendoModule ein vorhandenes Modul nicht überschrieben wird. Verwenden Sie den Force-Parameter , um die vorhandene Datei zu überschreiben, oder entfernen Sie sie, bevor Sie ausführen Export-CrescendoModule.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Der Name der Moduldatei, die Sie erstellen möchten. Sie können das nachfolgende .psm1weglassen.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoClobberManifest

Verhindert das Überschreiben des Modulmanifests.

Sie müssen das Manifest manuell mit neuen Cmdlets und Einstellungen aktualisieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Geben Sie ein -Objekt mit dem Pfad zu .psm1 und den Argumenten zu New-ModuleManifest aus.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String[]

Ausgaben

Object

Hinweise

Intern ruft diese Funktion das Cmdlet auf, das Import-CommandConfiguration ein Befehlsobjekt zurückgibt. Alle im Parameter ConfigurationFile bereitgestellten Dateien werden dann verwendet, um jede einzelne Funktion zu erstellen. Schließlich werden alle Proxys verwendet, um einen Export-ModuleMember Befehlsaufruf zu erstellen. Wenn das resultierende Modul importiert wird, verfügt das Modul über alle verfügbaren Befehlsproxys.

Export-CrescendoModule fügt dem Modulmanifest das CrescendoBuilt-Tag hinzu. Sie können dieses Tag verwenden, um Module in der PowerShell-Katalog zu suchen, die mit Crescendo erstellt wurden. Weitere Informationen finden Sie unter