Verweigert den Zugriff auf die Sitzungskonfigurationen auf dem lokalen Computer.

Syntax

Disable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-Bestätigung] [-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

-Bestätigung

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

None

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



Inhaltsverzeichnis