Megosztás a következőn keresztül:

Unregister-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Alapértelmezett) 

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 érdekében Unregister-PSSessionConfiguration újraindítja 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 parancsmaggal á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 MaintenanceShell konfigurációt, és újraindítjuk a WinRM szolgáltatást. A Kényszerítse paraméter minden felhasználói üzenetet letilt a WinRM szolgáltatás újraindításához anélkül, hogy a rendszer rákérdezne.

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ő 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 törli a MaintenanceShell munkamenet-konfigurációt. 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.

Ezután a Get-PSSessionConfiguration megpróbálja lekérni a MaintenanceShell munkamenetet. Mivel a munkamenet el lett távolítva a WS-Management erőforrástáblából, Get-PSSessionConfiguration nem tudja 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 MaintenanceShell konfigurációt használja. A munkamenet ezúttal meghiúsul, mert a WinRM szolgáltatás újraindításakor a MaintenanceShell konfiguráció törölve lett.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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ő.

A munkamenet-konfigurációkat a Unregister-PSSessionConfigurationis futtathatja.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

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

Ha egy Unregister-PSSessionConfiguration parancsot futtat, a rendszer alapértelmezés szerint arra kéri, hogy indítsa újra a WinRM szolgáltatást a módosítás hatékonyságának érdekében. 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, hogy Get-PSSessionConfiguration nem találja.

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

A munkamenet-konfigurációs objektumokat a Get-PSSessionConfiguration csövezheti ebbe a parancsmagba.

Kimenetek

None

Ez a parancsmag nem ad vissza objektumokat.

Jegyzetek

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

A parancsmag futtatásához a PowerShellt a Futtatás rendszergazdaként beállítással kell elindítania.