Add-SqlFirewallRule

Referência

Módulo:: SQLServer

Adiciona uma regra de Firewall do Windows para permitir conexões com uma instância específica do 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

O cmdlet Add-SqlFirewallRule adiciona uma regra de Firewall do Windows para permitir conexões para a instância especificada de SQL Server. O adaptador de nuvem SQL Server deve estar em execução e acessível no computador que hospeda a instância do SQL Server.

Esse cmdlet oferece suporte a estes modos de operação:

Especifique a instância Windows PowerShell caminho.
Especifique o objeto do servidor.
Especifique a instância do servidor da instância de destino do SQL Server.

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

Exemplos

Exemplo 1: Adicionar uma regra de Firewall do Windows no computador local

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

O primeiro comando altera o diretório para a instância do computador SQL Server.

Exemplo 2: Adicionar uma regra de Firewall do Windows no computador local por meio de um pipe

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

Esse comando obtém a instância SQL Server com base nas credenciais armazenadas na variável nomeada $Credentials. Em seguida, o comando canaliza as instâncias SQL Server de SQL Server no computador chamado 'Computer001'. Em seguida, o comando adiciona regras de Firewall do Windows para permitir conexões para cada uma das instâncias. O certificado autoassinado do computador de destino é aceito automaticamente sem avisar o usuário.

Parâmetros

-AutomaticallyAcceptUntrustedCertificates

Indica que esse cmdlet aceita automaticamente certificados não confiáveis.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet. Solicita a confirmação antes de executar o cmdlet.

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

-Credential

Especifica um objeto PSCredential para a conexão com SQL Server. Para obter um objeto de credencial, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

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

-InputObject

Especifica o objeto de servidor da instância de destino do SQL Server.

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementPublicPort

Especifica a porta de gerenciamento público no computador de destino. Esse parâmetro é usado quando as portas do computador de destino não estão diretamente acessíveis, mas são expostas por meio de pontos de extremidade, o que significa que elas precisam ser conectadas a uma porta diferente.

O adaptador de nuvem SQL Server deve estar acessível por essa porta.

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

-Path

Especifica o caminho para a instância de SQL Server na qual esse cmdlet executa a operação. Se esse parâmetro não for especificado, o valor desse parâmetro será padrão para o local de trabalho atual.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RetryTimeout

Especifica o período de tempo para tentar novamente o comando no servidor de destino. Depois que o tempo limite expirar, nenhuma nova tentativa será tentada.

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

-ServerInstance

Especifica o nome de uma instância de SQL Server, como uma matriz, que se torna o destino da operação.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado. Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Saídas

System.Object

Remove-SqlFirewallRule