Remove-Module

Module:

Microsoft.PowerShell.Core Module

Hiermee verwijdert u modules uit de huidige sessie.

Syntax

name

Remove-Module
    [-Name] <String[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullyQualifiedName

Remove-Module
    [-FullyQualifiedName] <ModuleSpecification[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ModuleInfo

Remove-Module
    [-ModuleInfo] <PSModuleInfo[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De cmdlet Remove-Module verwijdert de leden van een module, zoals cmdlets en functies, uit de huidige sessie.

Als de module een assembly (.dll) bevat, worden alle leden die door de assembly worden geïmplementeerd, verwijderd, maar wordt de assembly niet verwijderd.

Met deze cmdlet wordt de module niet verwijderd of verwijderd van de computer. Dit is alleen van invloed op de huidige PowerShell-sessie.

Voorbeelden

Voorbeeld 1: Een module verwijderen

Remove-Module -Name "BitsTransfer"

Met deze opdracht wordt de BitsTransfer-module uit de huidige sessie verwijderd.

Voorbeeld 2: Alle modules verwijderen

Get-Module | Remove-Module

Met deze opdracht worden alle modules uit de huidige sessie verwijderd.

Voorbeeld 3: Modules verwijderen met behulp van de pijplijn

"FileTransfer", "PSDiagnostics" | Remove-Module -Verbose

VERBOSE: Performing operation "Remove-Module" on Target "filetransfer (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\filetransfer\filetransfer.psd1')".
VERBOSE: Performing operation "Remove-Module" on Target "Microsoft.BackgroundIntelligentTransfer.Management (Path: 'C:\Windows\assembly\GAC_MSIL\Microsoft.BackgroundIntelligentTransfer.Management\1.0.0.0__31bf3856ad364e35\Microsoft.BackgroundIntelligentTransfe
r.Management.dll')".
VERBOSE: Performing operation "Remove-Module" on Target "psdiagnostics (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\psdiagnostics\psdiagnostics.psd1')".
VERBOSE: Removing imported function 'Start-Trace'.
VERBOSE: Removing imported function 'Stop-Trace'.
VERBOSE: Removing imported function 'Enable-WSManTrace'.
VERBOSE: Removing imported function 'Disable-WSManTrace'.
VERBOSE: Removing imported function 'Enable-PSWSManCombinedTrace'.
VERBOSE: Removing imported function 'Disable-PSWSManCombinedTrace'.
VERBOSE: Removing imported function 'Set-LogProperties'.
VERBOSE: Removing imported function 'Get-LogProperties'.
VERBOSE: Removing imported function 'Enable-PSTrace'.
VERBOSE: Removing imported function 'Disable-PSTrace'.
VERBOSE: Performing operation "Remove-Module" on Target "PSDiagnostics (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\psdiagnostics\PSDiagnostics.psm1')".

Met deze opdracht worden de BitsTransfer- en PSDiagnostics-modules uit de huidige sessie verwijderd.

De opdracht maakt gebruik van een pijplijnoperator (|) om de modulenamen te verzenden naar Remove-Module-. Het maakt gebruik van de uitgebreide algemene parameter voor gedetailleerde informatie over de leden die worden verwijderd.

In de uitgebreide berichten worden de items weergegeven die worden verwijderd. De berichten verschillen omdat de BitsTransfer-module een assembly bevat waarmee de cmdlets en een geneste module met een eigen assembly worden geïmplementeerd. De PSDiagnostics-module bevat een modulescriptbestand (.psm1) dat functies exporteert.

Voorbeeld 4: Een module verwijderen met ModuleInfo

$a = Get-Module BitsTransfer
Remove-Module -ModuleInfo $a

Met deze opdracht wordt de parameter ModuleInfo gebruikt om de BitsTransfer-module te verwijderen.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Cf

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Force

Geeft aan dat met deze cmdlet alleen-lezenmodules worden verwijderd. Remove-Module verwijdert standaard alleen modules voor lezen/schrijven.

De waarden ReadOnly en ReadW rite worden opgeslagen in eigenschap AccessMode van een module.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-FullyQualifiedName

Hiermee geeft u de volledig gekwalificeerde namen van modules die moeten worden verwijderd.

Parametereigenschappen

Type:	ModuleSpecification[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

FullyQualifiedName

Position:	0
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ModuleInfo

Hiermee geeft u de moduleobjecten die moeten worden verwijderd. Voer een variabele in die een moduleobject bevat (PSModuleInfo) of een opdracht waarmee een moduleobject wordt opgehaald, zoals een Get-Module opdracht. U kunt moduleobjecten ook doorsluisen naar Remove-Module-.

Parametereigenschappen

Type:	PSModuleInfo[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

ModuleInfo

Position:	0
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Name

Hiermee geeft u de namen van modules die moeten worden verwijderd. Jokertekens zijn toegestaan. U kunt ook tekenreeksen voor pijpnamen naar Remove-Module-.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	True
DontShow:	False

Parametersets

name

Position:	0
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Wi

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

System.String, System.Management.Automation.PSModuleInfo

U kunt modulenamen en moduleobjecten doorsluisen naar Remove-Module-.

Uitvoerwaarden

None

Met deze cmdlet wordt geen uitvoer gegenereerd.

Verwante koppelingen

• Get-Module
• Import-Module
• about_Modules