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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Gibt das Serverobjekt als Array der Zielinstanz an.

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

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

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Add-SqlFirewallRule