Add-SqlFirewallRule

  • Riferimento
Modulo:
SQLServer

Aggiunge una regola Windows Firewall per consentire connessioni a una specifica istanza di SQL Server.

Sintassi

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

Descrizione

Il cmdlet Add-SqlFirewallRule aggiunge una regola di Windows Firewall per consentire le connessioni per l'istanza specificata di SQL Server. L'adattatore cloud SQL Server deve essere in esecuzione e accessibile nel computer che ospita l'istanza di SQL Server.

Questo cmdlet supporta le modalità di esecuzione seguenti:

  • Specificare il percorso Windows PowerShell'istanza.
  • Specificare l'oggetto server.
  • Specificare l'istanza del server dell'istanza di destinazione di SQL Server.

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

Esempio

Esempio 1: Aggiungere una regola di Windows Firewall nel computer locale

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

Il primo comando modifica la directory nell'istanza del computer SQL Server.

Esempio 2: Aggiungere una regola di Windows Firewall nel computer locale tramite una pipe

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

Questo comando ottiene l'istanza di SQL Server in base alle credenziali archiviate nella variabile denominata $Credentials. Il comando invia quindi tramite pipe le istanze di SQL Server di SQL Server nel computer denominato "Computer001". Il comando aggiunge quindi regole di Windows Firewall per consentire le connessioni per ognuna delle istanze. Il certificato autofirmato del computer di destinazione viene accettato automaticamente senza chiedere conferma all'utente.

Parametri

-AutomaticallyAcceptUntrustedCertificates

Indica che questo cmdlet accetta automaticamente certificati non attendibili.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet. Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un oggetto PSCredential per la connessione a SQL Server. Per ottenere un oggetto credenziale, usare il cmdlet Get-Credential. Per altre informazioni, digitare Get-Help Get-Credential.

Tipo:PSCredential
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica l'oggetto server dell'istanza di destinazione di SQL Server.

Tipo:Server[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ManagementPublicPort

Specifica la porta di gestione pubblica nel computer di destinazione. Questo parametro viene usato quando le porte del computer di destinazione non sono direttamente accessibili, ma vengono esposte tramite endpoint, il che significa che devono essere connesse a una porta diversa.

L'adattatore cloud SQL Server deve essere accessibile da questa porta.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso dell'istanza di SQL Server in cui questo cmdlet esegue l'operazione. Se questo parametro non viene specificato, il valore di questo parametro viene impostato per impostazione predefinita sul percorso di lavoro corrente.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RetryTimeout

Specifica il periodo di tempo per ripetere il comando nel server di destinazione. Dopo la scadenza del timeout, non viene eseguito alcun tentativo.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServerInstance

Specifica il nome di un'istanza di SQL Server, come matrice, che diventa la destinazione dell'operazione.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito. Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Output

System.Object