Disable-PSSessionConfiguration
Verweigert den Zugriff auf die Sitzungskonfigurationen auf dem lokalen Computer.
Syntax
Disable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "Disable-PSSessionConfiguration" hindert alle Benutzer des Computers daran, die Sitzungskonfiguration in einer Sitzung zu verwenden. Dieses erweiterte Cmdlet wurde für Systemadministratoren entwickelt, die damit benutzerdefinierte Sitzungskonfigurationen für ihre Benutzer verwalten können.
Das Cmdlet "Disable-PSSessionConfiguration" fügt der Sicherheitsbeschreibung mindestens einer registrierten Sitzungskonfiguration die Einstellung "Alle verweigern" hinzu. Daraufhin können Sie die Registrierung von Konfigurationen aufheben, sie anzeigen und ändern, Sie können Konfigurationen jedoch nicht in einer Sitzung verwenden.
Ohne Parameter wird die Microsoft.PowerShell-Konfiguration, die die Standardkonfiguration für Sitzungen ist, von Disable-PSSessionConfiguration deaktiviert. Sofern der Benutzer keine andere Konfiguration angibt, werden sowohl lokale als auch Remotebenutzer effektiv an der Einrichtung von Sitzungen gehindert, die eine Verbindung mit dem Computer herstellen.
Um alle Sitzungskonfigurationen auf dem Computer zu deaktivieren, verwenden Sie Disable-PSRemoting.
Parameter
-Force
Unterdrückt alle Benutzeraufforderungen. Standardmäßig werden Sie aufgefordert, jeden Vorgang zu bestätigen.
Erforderlich? |
false |
Position? |
named |
Standardwert |
False |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt die Namen der zu deaktivierenden Sitzungskonfigurationen an. Geben Sie einen oder mehrere Konfigurationsnamen ein. Platzhalter sind zulässig. Sie können auch über die Pipeline eine Zeichenfolge, die einen Konfigurationsnamen oder ein Sitzungskonfigurationsobjekt enthält, an Disable-PSSessionConfiguration übergeben.
Wenn Sie diesen Parameter nicht angeben, deaktiviert Disable-PSSessionConfiguration die Microsoft.PowerShell-Sitzungskonfiguration.
Erforderlich? |
false |
Position? |
1 |
Standardwert |
Microsoft.PowerShell |
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
true |
-Confirm
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String Sie können über die Pipeline ein Sitzungskonfigurationsobjekt oder eine Zeichenfolge, die den Namen einer Sitzungskonfiguration enthält, an Disable-PSSessionConfiguration übergeben. |
Ausgaben |
Keiner Dieses Cmdlet gibt keine Objekte zurück. |
Hinweise
Sie müssen Windows PowerShell mit der Option "Als Administrator ausführen" starten, um dieses Cmdlet unter Windows Vista, Windows Server 2008 und höheren Versionen von Windows auszuführen.
Beispiel 1
C:\PS>Disable-PSSessionConfiguration
Beschreibung
-----------
Mit diesem Befehl wird die Microsoft.PowerShell-Sitzungskonfiguration deaktiviert.
Beispiel 2
C:\PS>disable-pssessionConfiguration -name *
Beschreibung
-----------
Mit diesem Befehl werden alle registrierten Sitzungskonfigurationen auf dem Computer deaktiviert.
Beispiel 3
C:\PS>disable-pssessionConfiguration -name Microsoft* -force
Beschreibung
-----------
Mit diesem Befehl werden alle Sitzungskonfigurationen deaktiviert, deren Namen mit "Microsoft" beginnt. Der Befehl verwendet den Force-Parameter zum Unterdrücken aller Benutzeraufforderungen des Befehls.
Beispiel 4
C:\PS>Get-PSSessionConfiguration -name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration
Beschreibung
-----------
Mit diesem Befehl werden die MaintenanceShell-Sitzungskonfiguration und die AdminShell-Sitzungskonfiguration deaktiviert.
Der Befehl verwendet einen Pipelineoperator (|), um die Ergebnisse eines Get-PSSessionConfiguration-Befehls an Disable-PSSessionConfiguration zu senden.
Beispiel 5
C:\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
C:\PS> Disable-PSSessionConfiguration -name MaintenanceShell -force
C:\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
C:\PS> Set-PSSessionConfiguration -name MaintenanceShell -MaximumReceivedDataSizePerCommandMB 60
ParamName ParamValue
--------- ----------
psmaximumreceived... 60
"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y
C:\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_Troubl
eshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed
Beschreibung
-----------
In diesem Beispiel wird veranschaulicht, wie sich das Deaktivieren einer Sitzungskonfiguration auswirkt.
Der erste Befehl verwendet die Cmdlets "Get-SessionConfiguration" und "Format-Table", um nur die Name-Eigenschaft und die Permission-Eigenschaft der Sitzungskonfigurationsobjekte anzuzeigen. In diesem Tabellenformat können die Werte der Objekte leichter eingesehen werden. Die Ergebnisse zeigen, dass Mitgliedern der Gruppe "Administratoren" erlaubt wird, die Sitzungskonfigurationen zu verwenden.
Der zweite Befehl verwendet das Cmdlet "Disable-PSSessionConfiguration", um die MaintenanceShell-Sitzungskonfiguration zu deaktivieren. Der Befehl verwendet den Force-Parameter zum Unterdrücken aller Benutzeraufforderungen.
Der dritte Befehl wiederholt den ersten Befehl. Die Ergebnisse zeigen, dass Sie weiterhin das Objekt abrufen können, das die MaintenanceShell-Sitzungskonfiguration darstellt, obwohl allen Benutzern der Zugriff darauf verweigert wurde. Der Eintrag "AccessDenied" hat Vorrang gegenüber allen anderen Einträgen in der Sicherheitsbeschreibung.
Der vierte Befehl verwendet das Cmdlet "Set-PSSessionConfiguration", um die Einstellung "MaximumDataSizePerCommandMB" für die MaintenanceShell-Sitzungskonfiguration auf 60 zu erhöhen. Die Ergebnisse zeigen, dass der Befehl erfolgreich war, obwohl allen Benutzern Zugriff auf die Konfiguration verweigert wurde.
Der fünfte Befehl versucht, die MaintenanceShell-Sitzungskonfiguration in einer Sitzung zu verwenden. Er verwendet das Cmdlet "New-PSSession", um eine neue Sitzung einzurichten, und den ConfigurationName-Parameter, um die MaintenanceShell-Konfiguration anzugeben. Die Ergebnisse zeigen, dass beim Befehl "New-PSSession" ein Fehler auftritt, weil dem Benutzer Zugriff auf die Konfiguration verweigert wird.
Siehe auch
Konzepte
about_Session_Configurations
Enable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider