Disable-PSSessionConfiguration
Letiltja a munkamenet-konfigurációkat a helyi számítógépen.
Syntax
Default (Alapértelmezett)
Disable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Ez a parancsmag csak a Windows platformon érhető el.
A Disable-PSSessionConfiguration parancsmag letiltja a munkamenet-konfigurációkat a helyi számítógépen, így minden felhasználó nem használhatja a munkamenet-konfigurációkat a felhasználó által felügyelt munkamenetek (PSSessions) létrehozásához a helyi számítógépen. Ez egy speciális parancsmag, amelyet a rendszergazdák a felhasználók testreszabott munkamenet-konfigurációinak kezelésére terveztek.
A PowerShell 3.0-tól kezdve a Disable-PSSessionConfiguration parancsmag a munkamenet-konfiguráció () WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled beállítását False értékre állítja.
A PowerShell 2.0-ban a Disable-PSSessionConfiguration parancsmag hozzáad egy Deny_All bejegyzést egy vagy több regisztrált munkamenet-konfiguráció biztonsági leírójába.
Paraméterek nélkül Disable-PSSessionConfiguration letiltja a Microsoft.PowerShell konfigurációt, amely a munkamenetekhez használt alapértelmezett konfiguráció. Ha a felhasználó nem határoz meg másik konfigurációt, a helyi és a távoli felhasználók hatékonyan nem hozhatnak létre a számítógéphez csatlakozó munkameneteket.
A számítógép összes munkamenet-konfigurációjának letiltásához használja a Disable-PSRemoting.
Példák
1. példa: Az alapértelmezett konfiguráció letiltása
Ez a példa letiltja a Microsoft.PowerShell munkamenet-konfigurációját.
Disable-PSSessionConfiguration
2. példa: Az összes regisztrált munkamenet-konfiguráció letiltása
Ez a példa letiltja a számítógépen található összes regisztrált munkamenet-konfigurációt.
Disable-PSSessionConfiguration -Name *
3. példa: Munkamenet-konfigurációk letiltása név szerint
Ez a példa letiltja az összes olyan munkamenet-konfigurációt, amelynek neve Microsoftkezdődik. A Kényszerített paraméter letiltja a parancsmag összes felhasználói kérését.
Disable-PSSessionConfiguration -Name Microsoft* -Force
4. példa: Munkamenet-konfigurációk letiltása a folyamat használatával
Ez a példa letiltja a MaintenanceShell- és Az AdminShell munkamenet-konfigurációit. A folyamatüzemeltető (|) elküldi egy Get-PSSessionConfiguration eredményeit Disable-PSSessionConfiguration.
Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration
5. példa: Munkamenet-konfiguráció letiltásának hatásai
Ez a példa a Disable-PSSessionConfiguration futtatása előtti és utáni engedélyeket, valamint a munkamenet-konfiguráció letiltásának hatását mutatja be.
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto
Name Permission
---- ----------
MaintenanceShell BUILTIN\Administrators AccessAllowed
microsoft.powershell BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed
PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto
Name Permission
---- ----------
MaintenanceShell Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed
PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell
[localhost] Connecting to remote server failed with the following error message : Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed
Megjegyzés:
A konfiguráció letiltása nem akadályozza meg, hogy a Set-PSSessionConfiguration parancsmaggal módosítsa a konfigurációt. Csak a konfiguráció használatát akadályozza meg.
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
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
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
A letiltandó munkamenet-konfigurációk nevének tömbje. Adjon meg egy vagy több konfigurációnevet. A helyettesítő karakterek használata engedélyezett. A Disable-PSSessionConfigurationegy konfigurációnevet vagy munkamenetkonfigurációs objektumot tartalmazó sztringet is beszúrhat.
Ha kihagyja ezt a paramétert, Disable-PSSessionConfiguration letiltja a Microsoft.PowerShell munkamenet-konfigurációját.
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ő: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-NoServiceRestart
A WSMan szolgáltatás újraindításának megakadályozására szolgál. A konfiguráció letiltásához nem szükséges újraindítani a szolgáltatást.
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 parancsmaghoz munkamenetkonfigurációs objektumot csövezhet.
String
Erre a parancsmagra egy munkamenet-konfiguráció nevét tartalmazó sztringet 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 beállítással kell elindítania.
Kapcsolódó hivatkozások
- PSSession konfiguráció engedélyezése
- Get-PSSessionConfiguration (PSSession konfiguráció lekérése)
- New-PSSessionConfigurationFile
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration (PowerShell munkamenet konfiguráció beállítása)
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan-szolgáltató
- a munkamenet-konfigurációk_ról
- A munkamenet-konfigurációs fájlokról