Unregister-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntax

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .