Sdílet prostřednictvím

Unregister-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

Odstraní registrované konfigurace relací z počítače.

Syntaxe

Unregister-PSSessionConfiguration
          [-Name] <String>
          [-Force]
          [-NoServiceRestart]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Unregister-PSSessionConfiguration odstraní registrované konfigurace relací z počítače. Tato rutina je určená pro správce systému ke správě přizpůsobených konfigurací relací pro uživatele.

Pokud chcete změnu provést efektivně, Unregister-PSSessionConfiguration restartuje službu WinRM. Chcete-li zabránit restartování, zadejte NoServiceRestart parametr.

Pokud omylem odstraníte výchozí konfigurace Microsoft.PowerShell nebo Microsoft.PowerShell32 relací, obnovte je pomocí rutiny Enable-PSRemoting. Další informace najdete v tématu about_Session_Configurations.

Příklady

Příklad 1: Odstranění konfigurace relace

Tento příklad odstraní konfiguraci relace MaintenanceShell z počítače.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Příklad 2: Odstranění konfigurace relace a restartování služby WinRM

V tomto příkladu odstraníme konfiguraci MaintenanceShell a restartujeme službu WinRM. Parametr Force potlačí všechny uživatelské zprávy, aby se služba WinRM restartoval bez výzvy.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Příklad 3: Odstranění všech konfigurací relací

Tento příklad ukazuje dva způsoby, jak odstranit všechny konfigurace relací v počítači. Oba příkazy mají stejný účinek a dají se použít zaměnitelně.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Příklad 4: Zrušení registrace bez restartování

Tento příklad ukazuje účinek použití parametru NoServiceRestart, aby se zabránilo restartování služby, které by přerušilo všechny relace v počítači.

PS> Unregister-PSSessionConfiguration -Name "MaintenanceShell" -NoServiceRestart
PS> Get-PSSessionConfiguration -Name "MaintenanceShell"

Get-PSSessionConfiguration -Name MaintenanceShell : No Session Configuration matches criteria "MaintenanceShell".
+ CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

PS> New-PSSession -ConfigurationName "MaintenanceShell"

Id Name      ComputerName    State    Configuration         Availability
-- ----      ------------    -----    -------------         ------------
1 Session1  localhost       Opened   MaintenanceShell      Available

PS> Restart-Service winrm
PS> New-PSSession -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message :
 The WS-Management service cannot process the request.
 The resource URI (http://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog.
 The catalog contains the metadata that describes resources, or logical endpoints.
 For more information, see the about_Remote_Troubleshooting Help topic.
 + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
 + FullyQualifiedErrorId : PSSessionOpenFailed

Unregister-PSSessionConfiguration odstraní konfiguraci relace MaintenanceShell. Vzhledem k tomu, že příkaz používá parametr NoServiceRestart, služba WinRM se nerestartuje a změna ještě není úplně efektivní.

V dalším kroku se Get-PSSessionConfiguration pokusí získat relaci MaintenanceShell. Vzhledem k tomu, že relace byla odebrána z tabulky prostředků WS-Management, Get-PSSessionConfiguration ji nemůže vrátit.

Rutina New-PSSession vytvoří relaci pomocí konfigurace MaintenanceShell. Příkaz bude úspěšný. Dále restartujeme službu WinRM.

Nakonec se rutina New-PSSession pokusí vytvořit relaci, která používá konfiguraci MaintenanceShell. Tentokrát relace selže, protože při restartování služby WinRM byla odstraněna konfigurace MaintenanceShell.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Označuje, že rutina nezobrazí výzvu k potvrzení a restartuje službu WinRM bez výzvy. Restartováním služby se změna konfigurace projeví.

Pokud chcete zabránit restartování a potlačit výzvu k restartování, použijte parametr NoServiceRestart.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje názvy konfigurací relace, které se mají odstranit. Zadejte jeden název konfigurace relace nebo vzor názvu konfigurace. Jsou povoleny zástupné znaky. Tento parametr je povinný.

Konfigurace relací můžete také převést na Unregister-PSSessionConfiguration.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-NoServiceRestart

Označuje, že tato rutina nerestartuje službu WinRM a potlačí výzvu k restartování služby.

Ve výchozím nastavení se při spuštění příkazu Unregister-PSSessionConfiguration zobrazí výzva k restartování služby WinRM, aby se změna projevila. Dokud se služba WinRM nerestartuje, můžou uživatelé dál používat konfiguraci neregistrované relace, i když ji Get-PSSessionConfiguration nenajde.

Pokud chcete službu WinRM restartovat bez výzvy, zadejte parametr Force. Pokud chcete službu WinRM restartovat ručně, použijte rutinu Restart-Service.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Do této rutiny můžete připojit objekt konfigurace relace.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Tato rutina je dostupná jenom na platformách Windows.

Pokud chcete tuto rutinu spustit, musíte spustit PowerShell pomocí možnosti Spustit jako správce.