Unregister-PSSessionConfiguration

  • Referencia
Modul:
Microsoft.PowerShell.Core

Törli a regisztrált munkamenet-konfigurációkat a számítógépről.

Syntax

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

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Unregister-PSSessionConfiguration parancsmag törli a regisztrált munkamenet-konfigurációkat a számítógépről. Ez a parancsmag a rendszergazdák számára lett kialakítva a felhasználók egyéni munkamenet-konfigurációinak kezelésére.

A módosítás hatékonyságának Unregister-PSSessionConfiguration érdekében indítsa újra a WinRM szolgáltatást. Az újraindítás megakadályozásához adja meg a NoServiceRestart paramétert.

Ha véletlenül törli az alapértelmezett Microsoft.PowerShell vagy Microsoft.PowerShell32 munkamenet-konfigurációkat, a Enable-PSRemoting parancsmag használatával állítsa vissza őket. További információ: about_Session_Configurations.

Példák

1. példa: Munkamenet-konfiguráció törlése

Ez a példa törli a MaintenanceShell munkamenet-konfigurációt a számítógépről.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

2. példa: Munkamenet-konfiguráció törlése és a WinRM szolgáltatás újraindítása

Ebben a példában töröljük a konfigurációt MaintenanceShell , és újraindítjuk a WinRM szolgáltatást. A Force paraméter letiltja az összes felhasználói üzenetet a WinRM szolgáltatás kérés nélküli újraindításához.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

3. példa: Az összes munkamenet-konfiguráció törlése

Ez a példa két módszert mutat be a számítógép összes munkamenet-konfigurációjának törlésére. Mindkét parancsnak ugyanaz a hatása, és felcserélhető.

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

4. példa: Regisztráció törlése újraindítás nélkül

Ez a példa azt mutatja be, hogy a NoServiceRestart paraméterrel megelőzhető-e a szolgáltatás újraindítása, amely megzavarná a számítógép munkameneteit.

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

A Unregister-PSSessionConfiguration rendszer törli a munkamenet-konfigurációt MaintenanceShell . Mivel azonban a parancs a NoServiceRestart paramétert használja, a WinRM szolgáltatás nem indul újra, és a módosítás még nem teljesen hatékony.

A következő lépés a Get-PSSessionConfiguration munkamenet lekérése MaintenanceShell . Mivel a munkamenet el lett távolítva a WS-Management erőforrástáblából, Get-PSSessionConfiguration nem lehet visszaadni.

A New-PSSession parancsmag létrehoz egy munkamenetet a MaintenanceShell konfigurációval. A parancs sikeres. Ezután újraindítjuk a WinRM szolgáltatást.

Végül a New-PSSession parancsmag megpróbál létrehozni egy munkamenetet, amely a konfigurációt MaintenanceShell használja. Ezúttal a munkamenet meghiúsul, mert a MaintenanceShell konfiguráció a WinRM szolgáltatás újraindításakor törölve lett.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Force

Azt jelzi, hogy a parancsmag nem kéri a megerősítést, és kérés nélkül újraindítja a WinRM szolgáltatást. A szolgáltatás újraindítása hatékonyabbá teszi a konfiguráció módosítását.

Az újraindítás megelőzéséhez és az újraindítási kérés letiltásához használja a NoServiceRestart paramétert.

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

-Name

Megadja a törölni kívánt munkamenet-konfigurációk nevét. Adjon meg egy munkamenet-konfigurációnevet vagy egy konfigurációnévmintát. A helyettesítő karakterek használata engedélyezett. Ez a paraméter kötelező.

Munkamenetkonfigurációkat is be lehet csövezni.Unregister-PSSessionConfiguration

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

-NoServiceRestart

Azt jelzi, hogy ez a parancsmag nem indítja újra a WinRM szolgáltatást, és letiltja a szolgáltatás újraindítására vonatkozó kérést.

Alapértelmezés szerint egy parancs futtatásakor Unregister-PSSessionConfiguration a rendszer kéri, hogy indítsa újra a WinRM szolgáltatást, hogy a módosítás érvényes legyen. A WinRM szolgáltatás újraindításáig a felhasználók továbbra is használhatják a nem regisztrált munkamenet-konfigurációt, annak ellenére Get-PSSessionConfiguration , hogy nem találják.

A WinRM szolgáltatás kérés nélküli újraindításához adja meg a Force paramétert. A WinRM szolgáltatás manuális újraindításához használja a Restart-Service parancsmagot.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

A parancsmaghoz munkamenetkonfigurációs objektumot csövezhet.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.

A parancsmag futtatásához a PowerShellt a Futtatás rendszergazdaként lehetőséggel kell elindítania.