Freigeben über

Add-SqlFirewallRule

  • Referenz
Modul:
SQLServer

Fügt eine Windows-Firewall-Regel hinzu, um Verbindungen mit einer bestimmten SQL Server-Instanz zuzulassen.

Syntax

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

Beschreibung

Das Cmdlet Add-SqlFirewallRule fügt eine Windows-Firewallregel hinzu, um Verbindungen für die angegebene Instanz von SQL Server zu ermöglichen. Der 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 die Serverinstanz 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: Hinzufügen einer Windows-Firewallregel auf dem lokalen Computer

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

Der erste Befehl ändert das Verzeichnis der SQL Server Computerinstanz.

Beispiel 2: Hinzufügen einer Windows-Firewallregel auf dem lokalen Computer über eine Pipeline

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer001" | Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Dieser Befehl ruft die SQL Server Instanz basierend auf den Anmeldeinformationen ab, die in der Variablen mit dem Namen $Credentials gespeichert sind. Der Befehl überschreibt dann die SQL Server Instanzen von SQL Server auf dem Computer namens "Computer001". Der Befehl fügt dann Windows-Firewallregeln hinzu, um Verbindungen für jede der Instanzen zu ermöglichen. 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

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen. Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

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

-Credential

Gibt ein PSCredential-Objekt für die Verbindung mit SQL Server an. Verwenden Sie zum Abrufen eines Anmeldeinformationenobjekts das Cmdlet Get-Credential. Weitere Informationen erhalten Sie, indem Sie Get-Help Get-Credential eingeben.

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

-InputObject

Gibt das Serverobjekt der Zielinstanz von SQL Server 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, was bedeutet, dass sie mit einem anderen Port verbunden sein müssen.

Der SQL Server CloudAdapter muss von diesem Port zugänglich sein.

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 dieser Parameter nicht angegeben wird, wird der Wert dieses Parameters auf den aktuellen Arbeitsspeicherort festgelegt.

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. Nachdem das Timeout abgelaufen ist, wird keine Wiederholung versucht.

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. 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[]

Ausgaben

System.Object