Add-SqlFirewallRule

Módulo:

SQLServer

Agrega una regla de Firewall de Windows para permitir conexiones con una instancia específica de SQL Server.

Sintaxis

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

Description

El cmdlet Add-SqlFirewallRule agrega una regla de Firewall de Windows para permitir conexiones para la instancia especificada de SQL Server. El adaptador de nube de SQL Server debe estar en ejecución y accesible en el equipo que hospeda la instancia de SQL Server.

Este cmdlet admite los modos de funcionamiento siguientes:

• Especifique la ruta de acceso de Windows PowerShell instancia.
• Especifique el objeto de servidor.
• Especifique la instancia de servidor de la instancia de destino de SQL Server.

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

Ejemplos

Ejemplo 1: Agregar una regla de Firewall de Windows en el equipo local

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

El primer comando cambia el directorio a la instancia de equipo de SQL Server.

Ejemplo 2: Agregar una regla de Firewall de Windows en el equipo local a través de una canalización

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

Este comando obtiene la instancia de SQL Server en función de las credenciales almacenadas en la variable denominada $Credentials. A continuación, el comando canaliza las instancias de SQL Server de SQL Server en el equipo denominado "Computer001". A continuación, el comando agrega reglas de Firewall de Windows para permitir conexiones para cada una de las instancias. El certificado autofirmado de la máquina de destino se acepta automáticamente sin preguntar al usuario.

Parámetros

-AutomaticallyAcceptUntrustedCertificates

Indica que este cmdlet acepta automáticamente certificados que no son de confianza.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet. Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Especifica un objeto PSCredential para la conexión a SQL Server. Para obtener un objeto de credencial, use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help Get-Credential.

Tipo:	PSCredential
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifica el objeto de servidor de la instancia de destino de SQL Server.

Tipo:	Server[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ManagementPublicPort

Especifica el puerto de administración pública en la máquina de destino. Este parámetro se usa cuando los puertos de la máquina de destino no son accesibles directamente, pero se exponen a través de puntos de conexión, lo que significa que deben conectarse a un puerto diferente.

Este puerto debe tener acceso al adaptador de nube de SQL Server.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

Especifica la ruta de acceso a la instancia de SQL Server en la que este cmdlet ejecuta la operación. Si no se especifica este parámetro, el valor de este parámetro tiene como valor predeterminado la ubicación de trabajo actual.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RetryTimeout

Especifica el período de tiempo que se va a reintentar el comando en el servidor de destino. Una vez expirado el tiempo de espera, no se intenta reintentar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServerInstance

Especifica el nombre de una instancia de SQL Server, como matriz, que se convierte en el destino de la operación.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta. Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Salidas

System.Object

Vínculos relacionados

• Remove-SqlFirewallRule