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.

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

-Confirm

Richiede la conferma dell'utente 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 account utente con le credenziali di amministratore di Windows nel computer di destinazione.

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

-Disable

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

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

-ForceServiceRestart

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

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

-InputObject

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

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

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

-NoServiceRestart

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

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

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

-Port

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

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

-Protocol

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

Type:Protocols
Accepted values:TCP
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetryTimeout

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

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

-ServerInstance

Specifica il nome di un'istanza, come matrice, di SQL Server 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.

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