Partager via

Set-SqlNetworkConfiguration

  • Référence
Module:
SQLServer

Définit la configuration réseau de l'instance cible de SQL Server.

Syntaxe

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

L’applet de commande Set-SqlNetworkConfiguration définit la configuration réseau de l’instance cible de SQL Server.

L'adaptateur de cloud SQL Server doit être en cours d'exécution et accessible sur l'ordinateur qui héberge l'instance de SQL Server.

Cette applet de commande prend en charge les modes de fonctionnement suivants :

  • Spécifiez l’instance du chemin d’accès Windows PowerShell.
  • Spécifiez l’objet serveur.
  • Spécifiez l’objet ServerInstance de l’instance cible de SQL Server.

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

Exemples

Exemple 1 : Définir la configuration réseau du SQL Server cible

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

La première commande remplace le répertoire SQLSERVER:\SQL\Computer\Instancepar . La deuxième commande définit la configuration réseau pour accepter TCP les connexions au port 1433 de l’instance de serveur nommée Computer\Instance. Le répertoire de travail actuel est utilisé pour déterminer l’instance de serveur où l’opération se produit. Le service SQL Server n’est pas redémarré automatiquement. Le certificat auto-signé de l’ordinateur cible est automatiquement accepté sans inviter l’utilisateur.

Exemple 2 : Définir la configuration réseau du SQL Server cible à l’aide du pipeline

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

Cette commande obtient toutes les instances de SQL Server sur l’ordinateur nommé Computer006 et désactive les TCP connexions pour chacune d’elles. Le service SQL Server n’est pas redémarré automatiquement. Le certificat auto-signé de l’ordinateur cible est automatiquement accepté sans inviter l’utilisateur.

Paramètres

-AutomaticallyAcceptUntrustedCertificates

Indique que cette applet de commande accepte automatiquement les certificats non approuvés.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un compte d’utilisateur avec les informations d’identification de l’administrateur Windows sur l’ordinateur cible.

Type:PSCredential
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Disable

Indique que cette applet de commande désactive le protocole réseau spécifié sur l’instance cible de SQL Server.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceServiceRestart

Indique que cette applet de commande force le service SQL Server à redémarrer, si nécessaire, sans inviter l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un tableau d’objets serveur de l’instance cible.

Type:Server[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ManagementPublicPort

Spécifie le port de gestion publique sur l’ordinateur cible. Ce paramètre est utilisé lorsque les ports de l’ordinateur cible ne sont pas directement accessibles, mais sont exposés via des points de terminaison. Cela signifie que cette applet de commande doit se connecter à un autre port.

L'adaptateur de cloud SQL Server doit être accessible au moyen de ce port.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoServiceRestart

Indique que cette applet de commande empêche le redémarrage du service SQL Server sans inviter l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès, sous la forme d’un tableau, à l’instance de SQL Server sur laquelle cette applet de commande exécute l’opération. Si vous ne spécifiez pas de valeur pour ce paramètre, l’applet de commande utilise l’emplacement de travail actuel.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Port

Spécifie le port pour accepter les connexions TCP. Pour configurer des ports dynamiques, ce paramètre doit avoir la valeur zéro.

Type:Int32
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Protocol

Spécifie le protocole réseau à configurer sur l'instance cible de SQL Server.

Type:Protocols
Valeurs acceptées:TCP
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RetryTimeout

Spécifie la période pendant laquelle réessayer la commande sur le serveur cible. Une fois le délai d'attente expiré, aucune nouvelle tentative n'est effectuée.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerInstance

Spécifie le nom d’une instance, en tant que tableau, de SQL Server qui devient la cible de l’opération.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]