Spécifier des instances dans le fournisseur SQL Server PowerShell

Les chemins d'accès spécifiés pour le fournisseur PowerShell SQL Server doivent identifier l'instance du Moteur de base de données et de l'ordinateur sur lequel elle s'exécute. La syntaxe pour spécifier l'ordinateur et l'instance doit être conforme aux règles relatives aux identificateurs SQL Server et aux chemins d'accès Windows PowerShell.

1. Avant de commencer : Limitations et restrictions

2. Pour spécifier une instance : Exemples

Avant de commencer

Le premier nœud venant après SQLSERVER:\SQL dans un chemin d'accès de fournisseur SQL Server est le nom de l'ordinateur qui exécute l'instance du Moteur de base de données ; par exemple :

SQLSERVER:\SQL\MyComputer

Si vous exécutez Windows PowerShell sur le même ordinateur que l'instance du Moteur de base de données, vous pouvez utiliser localhost ou (local) à la place du nom de l'ordinateur. Les scripts utilisant localhost ou (local) peuvent être exécutés sur n'importe quel ordinateur, sans qu'il soit nécessaire de les modifier pour refléter différents noms d'ordinateur.

Vous pouvez exécuter plusieurs instances du programme exécutable du Moteur de base de données sur le même ordinateur. Le nœud venant après le nom de l'ordinateur dans un chemin d'accès de fournisseur SQL Server identifie l'instance ; par exemple :

SQLSERVER:\SQL\MyComputer\MyInstance

Chaque ordinateur peut avoir une instance par défaut du Moteur de base de données. Vous ne spécifiez pas de nom pour l'instance par défaut lorsque vous l'installez. Si vous spécifiez seulement un nom d'ordinateur dans une chaîne de connexion, vous êtes connecté à l'instance par défaut sur cet ordinateur. Toutes les autres instances sur l'ordinateur doivent être des instances nommées. Vous spécifiez le nom de l'instance pendant l'installation, et les chaînes de connexion doivent spécifier à la fois le nom d'ordinateur et le nom de l'instance.

Limitations et restrictions

Vous ne pouvez pas utiliser de point (.) pour spécifier l'ordinateur local dans les scripts PowerShell. Le point n'est pas pris en charge car PowerShell l'interprète comme une commande.

Les parenthèses contenues dans (local) sont normalement traitées comme des commandes par Windows PowerShell. Vous devez les encoder ou les placer dans une séquence d'échappement pour une utilisation dans un chemin d'accès, ou mettre le chemin d'accès entre guillemets doubles. Pour plus d'informations, consultez Encoder et décoder des identificateurs SQL Server.

Le fournisseur SQL Server requiert que vous spécifiiez toujours un nom d'instance. Pour les instances par défaut, vous devez spécifier le nom de l'instance DEFAULT.

[Haut de la page]

Exemples : noms d'ordinateur et d'instance

Cet exemple utilise localhost et DEFAULT pour spécifier l'instance par défaut sur l'ordinateur local :

Set-Location SQLSERVER:\SQL\localhost\DEFAULT 

Les parenthèses contenues dans (local) sont normalement traitées comme des commandes par Windows PowerShell. Vous devez effectuer l'une des opérations suivantes :

• Mettre la chaîne de chemin d'accès entre guillemets :

  Set-Location "SQLSERVER:\SQL\(local)\DEFAULT"
  

• Placer la parenthèse dans une séquence d'échappement à l'aide du caractère « ` » (backtick) :

  Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT
  

• Encoder la parenthèse à l'aide de sa représentation hexadécimale :

  Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT
  

[Haut de la page]

Voir aussi

Concepts

Identificateurs SQL Server dans PowerShell

Fournisseur PowerShell SQL Server

SQL Server PowerShell