Share via

Set-SqlNetworkConfiguration

  • Referência
Módulo:
SQLServer

Define a configuração de rede da instância de destino do SQL Server.

Syntax

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

Description

O cmdlet Set-SqlNetworkConfiguration define a configuração de rede da instância de destino de SQL Server.

O Adaptador de Nuvem do 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 do caminho Windows PowerShell.
  • Especifique o objeto do servidor.
  • Especifique o objeto ServerInstance da instância de destino de 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: Definir a configuração de rede do SQL Server de destino

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

O primeiro comando altera o diretório para SQLSERVER:\SQL\Computer\Instance. O segundo comando define a configuração de rede para aceitar TCP conexões na porta 1433 para a instância de servidor nomeada Computer\Instance. O diretório de trabalho atual é usado para determinar a instância do servidor em que a operação ocorre. O serviço SQL Server não é reiniciado automaticamente. O certificado autoassinado do computador de destino é aceito automaticamente sem avisar o usuário.

Exemplo 2: Definir a configuração de rede do SQL Server de destino usando o pipeline

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

Esse comando obtém todas as instâncias de SQL Server no computador nomeado Computer006 e desabilita TCP conexões para cada uma delas. O serviço SQL Server não é reiniciado automaticamente. 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 sua 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 uma conta de usuário com credenciais de Administrador do Windows no computador de destino.

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

-Disable

Indica que esse cmdlet desabilita o protocolo de rede especificado na instância de destino do SQL Server.

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

-ForceServiceRestart

Indica que esse cmdlet força o serviço SQL Server a reiniciar, se necessário, sem solicitar ao usuário.

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

-InputObject

Especifica uma matriz de objetos de servidor da instância de destino.

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. Isso significa que esse cmdlet precisa se conectar a uma porta diferente.

O Adaptador de Nuvem do SQL Server deve estar acessível para essa porta.

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

-NoServiceRestart

Indica que esse cmdlet impede a reinicialização do serviço SQL Server sem avisar o usuário.

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

-Path

Especifica o caminho, como uma matriz, para a instância de SQL Server no qual esse cmdlet executa a operação. Se você não especificar um valor para esse parâmetro, o cmdlet usará o local de trabalho atual.

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

-Port

Especifica a porta para aceitar conexões TCP. Para configurar portas dinâmicas, esse parâmetro deverá ser definido como zero.

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

-Protocol

Especifica o protocolo de rede que desejamos configurar na instância de destino do SQL Server.

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

-RetryTimeout

Especifica o período de tempo para repetir o comando na severidade de destino. Após a expiração do tempo limite, nenhuma tentativa de repetição será realizada.

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, como uma matriz, de SQL Server 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.

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