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.

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

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

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

-InputObject

Gibt das Serverobjekt der Zielinstanz von SQL Server 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 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.

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

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

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

Ausgaben

System.Object

Remove-SqlFirewallRule