Unregister-PSSessionConfiguration
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í z počítače registrované konfigurace relací. 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 parametr NoServiceRestart .
Pokud omylem odstraníte výchozí Microsoft.PowerShell
konfiguraci nebo Microsoft.PowerShell32
konfiguraci relací, obnovte je pomocí Enable-PSRemoting
rutiny. Další informace najdete v tématu about_Session_Configurations.
Příklady
Příklad 1: Odstranění konfigurace relace
Tento příklad odstraní MaintenanceShell
konfiguraci relace 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 MaintenanceShell
odstraníme konfiguraci a restartujeme službu WinRM. Parametr Force potlačí všechny zprávy uživatelů, aby restartoval službu WinRM 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
MaintenanceShell
Odstraní Unregister-PSSessionConfiguration
konfiguraci relace.
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 Get-PSSessionConfiguration
se pokusí získat MaintenanceShell
relaci. Vzhledem k tomu, že relace byla odebrána z tabulky prostředků WS-Management, Get-PSSessionConfiguration
nelze ji vrátit.
Rutina New-PSSession
vytvoří relaci pomocí MaintenanceShell
konfigurace. Příkaz bude úspěšný. Dále restartujeme službu WinRM.
Nakonec se rutina New-PSSession
pokusí vytvořit relaci, která používá MaintenanceShell
konfiguraci. Tentokrát relace selže, protože MaintenanceShell
konfigurace byla odstraněna při restartování služby WinRM.
Parametry
-Confirm
Před spuštěním rutiny zobrazí výzvu 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ý.
Můžete také vést konfigurace relace do 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.
Při spuštění Unregister-PSSessionConfiguration
příkazu se ve výchozím nastavení zobrazí výzva k restartování služby WinRM, aby se změna projevila. Dokud se služba WinRM nerestartuje, můžou uživatelé stále používat konfiguraci neregistrované relace, i když Get-PSSessionConfiguration
ji nenajde.
Pokud chcete službu WinRM restartovat bez výzvy, zadejte parametr Force . Pokud chcete službu WinRM restartovat ručně, použijte tuto 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
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
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.
Chcete-li spustit tuto rutinu , musíte spustit PowerShell pomocí možnosti Spustit jako správce .
Související odkazy
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- Zprostředkovatel WSMan
- about_Session_Configurations
- about_Session_Configuration_Files