Set-SqlNetworkConfiguration

Módulo:

SqlServer Module

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

Sintaxe

ByPath (Padrão)

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

ByObject

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

ByName

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

Description

O cmdlet Set-SqlNetworkConfiguration define a configuração de rede da instância de destino do 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 dá suporte aos seguintes modos de operação:

• Especifique a instância do caminho do Windows PowerShell.
• Especifique o objeto do servidor.
• Especifique o objeto ServerInstance da instância de destino do 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 do servidor chamada 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 do 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 do SQL Server no computador nomeado Computer006 e desabilita TCP conexões para cada uma delas. O serviço do 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.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Credential

Especifica uma conta de usuário com credenciais de Administrador do Windows no computador de destino.

Propriedades do parâmetro

Tipo:	PSCredential
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Disable

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ForceServiceRestart

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-InputObject

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

Propriedades do parâmetro

Tipo:	Server[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByObject

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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 sã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 por essa porta.

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-NoServiceRestart

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Path

Especifica o caminho, como uma matriz, para a instância do SQL Server na 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.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByPath

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Port

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

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	2
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Protocol

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

Propriedades do parâmetro

Tipo:	Protocols
Valor padrão:	None
Valores aceitos:	TCP
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-RetryTimeout

Especifica o período de tempo para repetir o comando no sever de destino. Depois que o tempo limite expirar, nenhuma repetição será tentada.

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ServerInstance

Especifica o nome de uma instância, como uma matriz, do SQL Server que se torna o destino da operação.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByName

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Microsoft.SqlServer.Management.Smo.Server

System.String

Links Relacionados

• SQLServer_Cmdlets