Set-SqlNetworkConfiguration

  • Référence
Module:
SQLServer

Définit la configuration réseau de l'instance cible de 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

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-InputObject

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

Type:Server[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

Type:Protocols
Accepted values:TCP
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]