Set-SqlNetworkConfiguration

  • Riferimento
Modulo:
SQLServer

Imposta la configurazione di rete dell'istanza di destinazione di SQL Server.

Sintassi

Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-SqlNetworkConfiguration imposta la configurazione di rete dell'istanza di destinazione di SQL Server.

È necessario che l'adattatore cloud per SQL Server sia in esecuzione e accessibile nel computer che ospita l'istanza di SQL Server.

Questo cmdlet supporta le modalità di esecuzione seguenti:

  • Specificare l'istanza del percorso Windows PowerShell.
  • Specificare l'oggetto server.
  • Specificare l'oggetto ServerInstance 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: Impostare la configurazione di rete del SQL Server di destinazione

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Set-SqlNetworkConfiguration -Credential $credential -Protocol TCP -Port 1433 -NoServiceRestart -AcceptSelfSignedCertificate

Il primo comando modifica la directory in SQLSERVER:\SQL\Computer\Instance. Il secondo comando imposta la configurazione di rete per accettare TCP connessioni alla porta 1433 per l'istanza del server denominata Computer\Instance. La directory di lavoro corrente viene usata per determinare l'istanza del server in cui si verifica l'operazione. Il servizio SQL Server non viene riavviato automaticamente. Il certificato autofirmato del computer di destinazione viene accettato automaticamente senza richiedere all'utente.

Esempio 2: Impostare la configurazione di rete del SQL Server di destinazione usando la pipeline

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Set-SqlNetworkConfiguration -Credential $Credential -Protocol TCP -Disable -NoServiceRestart -AcceptSelfSignedCertificate;

Questo comando ottiene tutte le istanze di SQL Server nel computer denominato Computer006 e disabilita TCP le connessioni per ognuna di esse. Il servizio SQL Server non viene riavviato automaticamente. Il certificato autofirmato del computer di destinazione viene accettato automaticamente senza richiedere 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 la conferma dell'utente 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 account utente con le credenziali di amministratore di Windows nel computer di destinazione.

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

-Disable

Indica che questo cmdlet disabilita il protocollo di rete specificato nell'istanza di destinazione di SQL Server.

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

-ForceServiceRestart

Indica che questo cmdlet forza il servizio SQL Server a riavviare, se necessario, senza richiedere all'utente.

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

-InputObject

Specifica una matrice di oggetti server dell'istanza di destinazione.

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 accessibili direttamente, ma vengono esposte tramite endpoint. Ciò significa che questo cmdlet deve connettersi a una porta diversa.

L'adattatore cloud per 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

-NoServiceRestart

Indica che questo cmdlet impedisce il riavvio del servizio SQL Server senza richiedere all'utente.

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

-Path

Specifica il percorso, come matrice, all'istanza di SQL Server in cui questo cmdlet esegue l'operazione. Se non si specifica un valore per questo parametro, il cmdlet usa il percorso di lavoro corrente.

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

-Port

Specifica la porta per accettare connessioni TCP. Per configurare porte dinamiche, questo parametro deve essere impostato su zero.

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

-Protocol

Specifica il protocollo di rete che si desidera configurare nell'istanza di destinazione di SQL Server.

Tipo:Protocols
Valori accettati:TCP
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RetryTimeout

Specifica il periodo di tempo per riprovare il comando sulla destinazione. Una volta scaduto il timeout, non verranno effettuati ulteriori tentativi.

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, come matrice, di SQL Server 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.

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