Freigeben über

Remove-SqlFirewallRule

  • Referenz
Modul:
SQLServer

Deaktiviert die Windows-Firewall-Regel, die Verbindungen mit einer bestimmten SQL Server-Instanz zulässt.

Syntax

Remove-SqlFirewallRule
      [-Path <String[]>]
      [-Credential] <PSCredential>
      [-AutomaticallyAcceptUntrustedCertificates]
      [-ManagementPublicPort <Int32>]
      [-RetryTimeout <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SqlFirewallRule
      -InputObject <Server[]>
      [-Credential] <PSCredential>
      [-AutomaticallyAcceptUntrustedCertificates]
      [-ManagementPublicPort <Int32>]
      [-RetryTimeout <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SqlFirewallRule
      -ServerInstance <String[]>
      [-Credential] <PSCredential>
      [-AutomaticallyAcceptUntrustedCertificates]
      [-ManagementPublicPort <Int32>]
      [-RetryTimeout <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SqlFirewallRule deaktiviert die Windows-Firewallregel, die Verbindungen zu einer bestimmten Instanz von SQL Server ermöglicht.

SQL Server CloudAdapter muss auf dem Computer ausgeführt und zugänglich sein, auf dem die Instanz von SQL Server gehostet wird.

Dieses Cmdlet unterstützt die folgenden Vorgangsmodi:

  • Geben Sie die Instanz Windows PowerShell Pfad 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: Deaktivieren einer Windows-Firewallregel, die Verbindungen mit einer SQL Server Instanz blockiert

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Remove-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Dieser Befehl deaktiviert die Windows-Firewallregel auf dem Computer, um Verbindungen mit der SQL Server Instanz auf diesem Computer zu blockieren. Anhand des aktuellen Arbeitsverzeichnisses wird die Serverinstanz ermittelt, auf der der Vorgang erfolgen soll. Das selbstsignierte Zertifikat des Zielcomputers wird automatisch akzeptiert, ohne den Benutzer einzufordern.

Beispiel 2: Deaktivieren einer Windows-Firewallregel, die Verbindungen mit allen SQL Server Instanzen blockiert

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer002" | Remove-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Dieser Befehl ruft alle Instanzen von SQL Server auf dem Computer namens Computer002 ab und deaktiviert die Windows-Firewallregeln, um Verbindungen mit jedem von ihnen zu blockieren. 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

-InputObject

Gibt das Serverobjekt als Array 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 sollte verwendet werden, wenn die Ports des Zielcomputers nicht direkt zugänglich sind, aber über Endpunkte verfügbar gemacht werden, was bedeutet, dass wir eine Verbindung mit einem anderen Port herstellen müssen.

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

-Path

Gibt den Pfad zur 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

-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 von SQL Server als Array an, das 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[]