Angeben von Instanzen im SQL Server PowerShell-Anbieter

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Die für den SQL Server PowerShell-Anbieter angegebenen Pfade müssen die Instanz von Datenbank-Engine und den Computer, auf dem sie ausgeführt wird, angeben. Die Syntax zum Angeben des Computers und der Instanz muss sowohl den Regeln für die SQL Server-Bezeichner als auch für die Windows PowerShell-Pfade entsprechen.

Hinweis

Es gibt zwei SQL Server PowerShell-Module: SqlServer und SQLPS.

Das SqlServer-Modul ist das zu verwendende aktuelle PowerShell-Modul.

Das SQLPS-Modul ist zwar in der SQL Server-Installation (für die Abwärtskompatibilität) enthalten, wird jedoch nicht mehr aktualisiert.

Das SqlServer-Modul enthält aktualisierte Versionen der Cmdlets in SQLPS sowie neue Cmdlets zur Unterstützung der neuesten SQL-Funktionen.

Installieren Sie das SqlServer-Modul aus dem PowerShell-Katalog.

Weitere Informationen finden Sie unter SQL Server-PowerShell.

Vorbereitungen

Der erste Knoten, der auf SQLSERVER:\SQL in einem SQL Server-Anbieterpfad folgt, ist der Name des Computers, auf dem die Instanz von Datenbank-Engineausgeführt wird, z. B.:

SQLSERVER:\SQL\MyComputer  

Wenn Sie Windows PowerShell auf demselben Computer ausführen wie die Instanz von Datenbank-Engine, können Sie anstelle des Computernamens entweder "localhost" oder "(local)" verwenden. Skripts, die "localhost" oder "(local)" verwenden, können auf jedem Computer ausgeführt werden, ohne entsprechend dem jeweiligen Computernamen geändert werden zu müssen.

Sie können mehrere Instanzen des ausführbaren Programms Datenbank-Engine auf demselben Computer ausführen. Der Knoten, der dem Computernamen in einem SQL Server-Anbieterpfad folgt, gibt die Instanz an, z. B.:

SQLSERVER:\SQL\MyComputer\MyInstance  

Jeder Computer kann eine Standardinstanz von Datenbank-Engineaufweisen. Sie geben bei der Installation keinen Namen für die Standardinstanz an. Wenn Sie in einer Verbindungszeichenfolge nur einen Computernamen angeben, werden Sie mit der Standardinstanz auf diesem Computer verbunden. Alle anderen Instanzen auf dem Computer müssen benannte Instanzen sein. Sie geben den Instanznamen während des Setups ein, und die Verbindungszeichenfolgen müssen sowohl den Computernamen als auch den Instanznamen angeben.

Einschränkungen

Sie können keinen Punkt (.) verwenden, um den lokalen Computer in PowerShell-Skripts anzugeben. Der Punkt wird nicht unterstützt, da der Punkt von PowerShell als Befehl interpretiert wird.

Die Klammerzeichen in "(local)" werden von Windows PowerShell normalerweise als Befehle behandelt. Sie müssen sie entweder codieren, sie zur Verwendung in einem Pfad mit Escapezeichen versehen oder den Pfad in doppelte Anführungszeichen setzen. Weitere Informationen finden Sie unter "Codierung und Decodierung von SQL Server-Bezeichnern".

Für den SQL Server -Anbieter ist immer die Angabe eines Instanznamens erforderlich. Für Standardinstanzen müssen Sie den Instanznamen DEFAULT angeben.

Beispiele; Computer- und Instanznamen

Bei diesem Beispiel wird die Standardinstanz auf dem lokalen Computer mithilfe von "localhost" und DEFAULT angegeben:

Set-Location SQLSERVER:\SQL\localhost\DEFAULT   

Die Klammerzeichen in "(local)" werden von Windows PowerShell normalerweise als Befehle behandelt. Daher müssen Sie entweder:

• die Pfadzeichenfolge in Anführungszeichen setzen:

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

• die Klammer mit dem Graviszeichen (`) versehen:

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

• die Klammer in ihrer hexadezimalen Darstellung codieren:

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

Weitere Informationen

SQL Server-Bezeichnern in PowerShell
SQL Server PowerShell-Anbieter
SQL Server-PowerShell