Add-SqlFirewallRule
Fügt eine Windows-Firewallregel hinzu, um Verbindungen mit einer bestimmten Instanz von SQL Server zuzulassen.
Syntax
ByPath (Standardwert)
Add-SqlFirewallRule
[-Credential] <PSCredential>
[-Path <String[]>]
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlFirewallRule
[-Credential] <PSCredential>
-InputObject <Server[]>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Add-SqlFirewallRule
[-Credential] <PSCredential>
-ServerInstance <String[]>
[-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 zuzulassen. 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 Betriebsmodi:
- Geben Sie den Windows PowerShell-Instanzpfad 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 in der SQL Server-Computerinstanz.
Beispiel 2: Hinzufügen einer Windows-Firewallregel auf dem lokalen Computer über eine Pipe
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 gibt dann die SQL Server-Instanzen von SQL Server auf dem Computer mit dem Namen "Computer001" an. Der Befehl fügt dann Windows-Firewallregeln hinzu, um Verbindungen für jede instanz zuzulassen. Das selbstsignierte Zertifikat des Zielcomputers wird automatisch akzeptiert, ohne den Benutzer aufzufordern.
Parameter
-AutomaticallyAcceptUntrustedCertificates
Gibt an, dass dieses Cmdlet automatisch nicht vertrauenswürdige Zertifikate akzeptiert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf. Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein PSCredential -Objekt für die Verbindung mit SQL Server an. Verwenden Sie das Cmdlet Get-Credential, um ein Anmeldeinformationsobjekt abzurufen. Geben Sie Get-Help Get-Credential ein, um weitere Informationen zu erhalten.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Gibt das Serverobjekt der Zielinstanz von SQL Server an.
Parametereigenschaften
| Typ: | Server[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByObject
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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 werden müssen.
Auf den SQL Server-Cloudadapter muss über diesen Port zugegriffen werden kann.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Path
Gibt den Pfad zur Instanz von SQL Server an, auf der dieses Cmdlet den Vorgang ausführt. Wenn dieser Parameter nicht angegeben ist, wird der Wert dieses Parameters standardmäßig auf den aktuellen Arbeitsspeicherort festgelegt.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByPath
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RetryTimeout
Gibt den Zeitraum an, um den Befehl auf dem Zielserver erneut zu versuchen. Nach Ablauf des Timeouts wird kein Wiederholungsversuch versucht.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ServerInstance
Gibt den Namen einer Instanz von SQL Server als Array an, die zum Ziel des Vorgangs wird.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
Microsoft.SqlServer.Management.Smo.Server
System.String[]