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.

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

-Confirm

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

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

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

-InputObject

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

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

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

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

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

-ServerInstance

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

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

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

Input

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Output

System.Object

Remove-SqlFirewallRule