Set-SqlNetworkConfiguration

Módulo:

SqlServer Module

Establece la configuración de red de la instancia de destino de SQL Server.

Sintaxis

ByPath (Es el valor predeterminado).

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

El cmdlet Set-SqlNetworkConfiguration establece la configuración de red de la instancia de destino de SQL Server.

El adaptador en la nube de SQL Server debe estar en ejecución y accesible en la máquina que hospeda la instancia de SQL Server.

Este cmdlet admite los siguientes modos de funcionamiento:

• Especifique la instancia de la ruta de acceso de Windows PowerShell.
• Especifique el objeto de servidor.
• Especifique el objeto ServerInstance de la instancia 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.

Ejemplos

Ejemplo 1: Establecer la configuración de red del servidor 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

El primer comando cambia el directorio a SQLSERVER:\SQL\Computer\Instance. El segundo comando establece la configuración de red para aceptar TCP conexiones en el puerto 1433 de la instancia del servidor denominada Computer\Instance. El directorio de trabajo actual se usa para determinar la instancia del servidor donde se produce la operación. El servicio SQL Server no se reinicia automáticamente. El certificado autofirmado de la máquina de destino se acepta automáticamente sin preguntar al usuario.

Ejemplo 2: Establecimiento de la configuración de red del servidor SQL Server de destino mediante la canalización

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

Este comando obtiene todas las instancias de SQL Server en el equipo denominado Computer006 y deshabilita las TCP conexiones para cada una de ellas. El servicio SQL Server no se reinicia automáticamente. El certificado autofirmado de la máquina de destino se acepta automáticamente sin preguntar al usuario.

Parámetros

-AutomaticallyAcceptUntrustedCertificates

Indica que este cmdlet acepta automáticamente certificados que no son de confianza.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Credential

Especifica una cuenta de usuario con credenciales de administrador de Windows en el equipo de destino.

Propiedades del parámetro

Tipo:	PSCredential
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	0
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Disable

Indica que este cmdlet deshabilita el protocolo de red especificado en la instancia de destino de SQL Server.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ForceServiceRestart

Indica que este cmdlet obliga al servicio SQL Server a reiniciarse, si es necesario, sin preguntar al usuario.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InputObject

Especifica una matriz de objetos de servidor de la instancia de destino.

Propiedades del parámetro

Tipo:	Server[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ByObject

Posición:	Named
Mandatory:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ManagementPublicPort

Especifica el puerto de administración pública en el equipo de destino. Este parámetro se usa cuando los puertos del equipo de destino no son accesibles directamente, pero se exponen a través de puntos de conexión. Esto significa que este cmdlet debe conectarse a un puerto diferente.

Este puerto debe tener acceso al adaptador en la nube de SQL Server.

Propiedades del parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-NoServiceRestart

Indica que este cmdlet impide un reinicio del servicio SQL Server sin preguntar al usuario.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Path

Especifica la ruta de acceso, como matriz, a la instancia de SQL Server en la que este cmdlet ejecuta la operación. Si no especifica un valor para este parámetro, el cmdlet usa la ubicación de trabajo actual.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ByPath

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Port

Especifica el puerto para aceptar conexiones TCP. Para configurar puertos dinámicos, este parámetro debe establecerse en cero.

Propiedades del parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	2
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Protocol

Especifica el protocolo de red que queremos configurar en la instancia de destino de SQL Server.

Propiedades del parámetro

Tipo:	Protocols
Valor predeterminado:	None
Valores aceptados:	TCP
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	1
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-RetryTimeout

Especifica el período de tiempo para reintentar el comando en el servidor de destino. Una vez expirado el tiempo de espera, no se intentará ningún reintento.

Propiedades del parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ServerInstance

Especifica el nombre de una instancia, como una matriz, de SQL Server que se convierte en el destino de la operación.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ByName

Posición:	Named
Mandatory:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Microsoft.SqlServer.Management.Smo.Server

System.String

Vínculos relacionados

• SQLServer_Cmdlets