Sdílet prostřednictvím

Unregister-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Výchozí) 

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

Description

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í Microsoft.PowerShell nebo konfigurace relací Microsoft.PowerShell32, použijte k jejich obnovení rutinu 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 MaintenanceShellu 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 MaintenanceShellu 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 (https://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 MaintenanceShellu. Vzhledem k tomu, že příkaz používá parametr NoServiceRestart, služba WinRM se nerestartuje a změna ještě není úplně efektivní.

Dále se Get-PSSessionConfiguration pokusí získat relaci MaintenanceShellu. Vzhledem k tomu, že relace byla odebrána z tabulky prostředků WS-Management, Get-PSSessionConfiguration ji nemůže vrátit.

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

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

Parametry

-Confirm

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Objekt konfigurace relace můžete převést z Get-PSSessionConfiguration do této rutiny.

Výstupy

None

Tato rutina nevrací žádné objekty.

Poznámky

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