Freigeben über

Set-SqlNetworkConfiguration

  • Referenz
Modul:
SQLServer

Legt die Netzwerkkonfiguration der SQL Server-Zielinstanz fest.

Syntax

Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SqlNetworkConfiguration legt die Netzwerkkonfiguration der Zielinstanz von SQL Server fest.

Auf dem Computer, der die SQL Server-Instanz hostet, muss der SQL Server-Cloud-Adapter ausgeführt werden und verfügbar sein.

Dieses Cmdlet unterstützt die folgenden Vorgangsmodi:

  • Geben Sie die Instanz des Windows PowerShell Pfads an.
  • Geben Sie das Serverobjekt an.
  • Geben Sie das ServerInstance-Objekt der Zielinstanz von SQL Server an.

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

Beispiele

Beispiel 1: Festlegen der Netzwerkkonfiguration des Ziels SQL Server

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Set-SqlNetworkConfiguration -Credential $credential -Protocol TCP -Port 1433 -NoServiceRestart -AcceptSelfSignedCertificate

Der erste Befehl ändert das Verzeichnis in SQLSERVER:\SQL\Computer\Instance. Der zweite Befehl legt die Netzwerkkonfiguration fest, um Verbindungen am Port 1433 für die Serverinstanz namens Computer\Instancezu akzeptierenTCP. Das aktuelle Arbeitsverzeichnis wird verwendet, um die Serverinstanz zu bestimmen, in der der Vorgang auftritt. Der SQL Server Dienst wird nicht automatisch neu gestartet. Das selbstsignierte Zertifikat des Zielcomputers wird automatisch akzeptiert, ohne den Benutzer einzufordern.

Beispiel 2: Festlegen der Netzwerkkonfiguration des Ziels SQL Server mithilfe der Pipeline

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Set-SqlNetworkConfiguration -Credential $Credential -Protocol TCP -Disable -NoServiceRestart -AcceptSelfSignedCertificate;

Dieser Befehl ruft alle Instanzen von SQL Server auf dem Computer namens Computer006 ab und deaktiviert TCP Verbindungen für jede von ihnen. Der SQL Server Dienst wird nicht automatisch neu gestartet. Das selbstsignierte Zertifikat des Zielcomputers wird automatisch akzeptiert, ohne den Benutzer einzufordern.

Parameter

-AutomaticallyAcceptUntrustedCertificates

Gibt an, dass dieses Cmdlet automatisch nicht vertrauenswürdige Zertifikate akzeptiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein Benutzerkonto mit Windows-Administratoranmeldeinformationen auf dem Zielcomputer an.

Typ:PSCredential
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Disable

Gibt an, dass dieses Cmdlet das angegebene Netzwerkprotokoll auf der Zielinstanz von SQL Server deaktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceServiceRestart

Gibt an, dass dieses Cmdlet den SQL Server Dienst erzwingt, wenn erforderlich, ohne den Benutzer zu starten.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Array von Serverobjekten der Zielinstanz an.

Typ:Server[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ManagementPublicPort

Gibt den öffentlichen Verwaltungsport auf dem Zielcomputer an. Dieser Parameter wird verwendet, wenn die Ports des Zielcomputers nicht direkt zugänglich sind, aber über Endpunkte verfügbar gemacht werden. Dies bedeutet, dass dieses Cmdlet eine Verbindung mit einem anderen Port herstellen muss.

Dieser Port muss den Zugriff auf den SQL Server-Cloud-Adapter ermöglichen.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoServiceRestart

Gibt an, dass dieses Cmdlet verhindert, dass ein Neustart des SQL Server-Diensts verhindert wird, ohne den Benutzer einzufordern.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad als Array an die Instanz von SQL Server an, auf der dieses Cmdlet den Vorgang ausführt. Wenn Sie keinen Wert für diesen Parameter angeben, verwendet das Cmdlet den aktuellen Arbeitsstandort.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Port

Gibt den Port an, der TCP-Verbindungen akzeptiert. Zum Konfigurieren dynamischer Ports sollte dieser Parameter auf 0 (null) festgelegt werden.

Typ:Int32
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Gibt das Netzwerkprotokoll an, das auf der SQL Server-Zielinstanz konfiguriert werden soll.

Typ:Protocols
Zulässige Werte:TCP
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RetryTimeout

Gibt den Zeitraum an, um den Befehl auf dem Zielserver erneut zu wiederholen. Nach Ablauf des Timeouts werden keine weiteren Wiederholungen ausgeführt.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerInstance

Gibt den Namen einer Instanz als Array SQL Server an, die zum Ziel des Vorgangs wird.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]