Disable-PSSessionConfiguration

Letiltja a munkamenet-konfigurációkat a helyi számítógépen.

Syntax

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 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 arra terveztek, hogy egyéni munkamenet-konfigurációkat kezeljenek a felhasználók számára.

A PowerShell 3.0-tól kezdve a Disable-PSSessionConfiguration parancsmag a munkamenet-konfiguráció (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) Engedélyezett beállítását False (Hamis) é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 Disable-PSSessionConfiguration nélkül letiltja a Munkamenetekhez használt alapértelmezett Microsoft.PowerShell-konfigurációt . Ha a felhasználó más konfigurációt nem ad meg, a helyi és a távoli felhasználók sem hozhatnak létre a számítógéphez csatlakozó munkameneteket.

A számítógépen található összes munkamenet-konfiguráció letiltásához használja a következőt 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 regisztrált munkamenet-konfigurációkat.

Disable-PSSessionConfiguration -Name *

3. példa: Munkamenet-konfigurációk letiltása név alapján

Ez a példa letiltja az összes olyan munkamenet-konfigurációt, amelynek a neve ezzel kezdődik Microsoft. A Force 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-munkamenetkonfigurációkat . The pipeline operator (|) sends the results of a Get-PSSessionConfiguration to 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 futtatás Disable-PSSessionConfiguration 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 parancsmaggal módosítsa a Set-PSSessionConfiguration konfigurációt. Csak a konfiguráció használatát akadályozza meg.

Paraméterek

-Confirm

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

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

-Force

Kényszeríti a parancs futtatását a felhasználó megerősítésének kérése nélkül.

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

-Name

A letiltandó munkamenet-konfigurációk nevének tömbje. Adjon meg egy vagy több konfigurációnevet. Helyettesítő karakterek használata engedélyezett. Egy konfigurációnevet vagy munkamenet-konfigurációs objektumot tartalmazó sztringet is átadhat a parancsnak Disable-PSSessionConfiguration.

Ha kihagyja ezt a paramétert, Disable-PSSessionConfiguration letiltja a Microsoft.PowerShell-munkamenet konfigurációját.

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

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

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

Bevitelek

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Erre a parancsmagra egy munkamenet-konfigurációs objektumot vagy egy olyan sztringet helyezhet át, amely a munkamenet-konfiguráció nevét tartalmazza.

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 lehetőséggel kell elindítania.