Add-SqlFirewallRule

Módulo:

SQLServer

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

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

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.

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

-Confirm

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

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

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

-InputObject

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

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

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

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

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

-ServerInstance

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

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

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

Entradas

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Salidas

System.Object

Vínculos relacionados

• Remove-SqlFirewallRule