Disable-PSSessionConfiguration

  • Referencia
Modul:
Microsoft.PowerShell.Core

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 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 hamisra állítja a munkamenet-konfiguráció engedélyezett beállítását (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled).

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ó 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é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 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 a kezdőbetűvel Microsoftkezdődik. 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 a Rendszergazda Shell-munkamenet konfigurációját. A folyamatüzemeltető (|) elküldi a folyamat eredményeit Get-PSSessionConfiguration a következőnek 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

Feljegyzé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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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. A helyettesítő karakterek használata engedélyezett. Olyan sztringet is beszúrhat, amely egy konfigurációnevet vagy egy munkamenetkonfigurációs objektumot Disable-PSSessionConfigurationtartalmaz.

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

Type:String[]
Position:0
Default value:None
Required:False
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
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.

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