Share via

Remove-Module

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Geçerli oturumdan modülleri kaldırır.

Syntax

Remove-Module
      [-Name] <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Module
      [-FullyQualifiedName] <ModuleSpecification[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Module
      [-ModuleInfo] <PSModuleInfo[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-Module cmdlet'i, cmdlet'ler ve işlevler gibi bir modülün üyelerini geçerli oturumdan kaldırır.

Modülde bir derleme (.dll) varsa, derleme tarafından uygulanan tüm üyeler kaldırılır, ancak derleme kaldırılmaz.

Bu cmdlet modülü kaldırmaz veya bilgisayardan silmez. Yalnızca geçerli PowerShell oturumunu etkiler.

Örnekler

Örnek 1: Modülü kaldırma

Remove-Module -Name "BitsTransfer"

Bu komut, BitsTransfer modülünü geçerli oturumdan kaldırır.

Örnek 2: Tüm modülleri kaldırma

Get-Module | Remove-Module

Bu komut geçerli oturumdaki tüm modülleri kaldırır.

Örnek 3: İşlem hattını kullanarak modülleri kaldırma

"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')".

Bu komut, BitsTransfer ve PSDiagnostics modüllerini geçerli oturumdan kaldırır.

Komut, modül adlarını Remove-Module'e göndermek için bir işlem hattı işleci (|) kullanır. Kaldırılan üyeler hakkında ayrıntılı bilgi almak için Ayrıntılı ortak parametresini kullanır.

Ayrıntılı iletiler kaldırılan öğeleri gösterir. BitsTransfer modülü cmdlet'lerini uygulayan bir derleme ve kendi derlemesine sahip iç içe bir modül içerdiğinden iletiler farklılık gösterir. PSDiagnostics modülü, işlevleri dışarı aktaran bir modül betik dosyası (.psm1) içerir.

Örnek 4: ModuleInfo kullanarak modülü kaldırma

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

Bu komut, BitsTransfer modülünü kaldırmak için ModuleInfo parametresini kullanır.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Force

Bu cmdlet'in salt okunur modülleri kaldırdığını gösterir. Varsayılan olarak, Remove-Module yalnızca okuma-yazma modüllerini kaldırır.

ReadOnly ve ReadWrite değerleri bir modülün AccessMode özelliğinde depolanır.

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

-FullyQualifiedName

Kaldırılacak modüllerin tam adlarını belirtir.

Type:ModuleSpecification[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleInfo

Kaldırılacak modül nesnelerini belirtir. Modül nesnesi (PSModuleInfo) içeren bir değişken veya Get-Module komutu gibi bir modül nesnesi alan bir komut girin. Modül nesnelerini Remove-Module'e de aktarabilirsiniz.

Type:PSModuleInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Kaldırılacak modüllerin adlarını belirtir. Joker karakterlere izin verilir. Ayrıca, ad dizelerini Remove-Module'e de aktarabilirsiniz.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

System.String, System.Management.Automation.PSModuleInfo

Modül adlarını ve modül nesnelerini Remove-Module'e aktarabilirsiniz.

Çıkışlar

None

Bu cmdlet herhangi bir çıkış oluşturmaz.

Notlar

Bir modülü kaldırırken, modülde yürütülecek bir olay vardır. Bu olay, bir modülün kaldırılmaya tepki vermesine ve kaynakları boşaltma gibi bazı temizleme işlemleri gerçekleştirmesine olanak tanır. Örnek:

$OnRemoveScript = {

# temizleme gerçekleştir

$cachedSessions | Remove-PSSession

}

$ExecutionContext.SessionState.Module.OnRemove += $OnRemoveScript

Tam tutarlılık için PowerShell işleminin kapatılmasına tepki vermek de yararlı olabilir:

Register-EngineEvent -SourceIdentifier ([System.Management.Automation.PsEngineEvent]::Exiting) -Action $OnRemoveScript