Angeben von Instanzen im SQL Server PowerShell-Anbieter
Die für den SQL Server PowerShell-Anbieter angegebenen Pfade müssen die Instanz von Database Engine (Datenbankmodul) 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.
Vorbereitungen: Einschränkungen
Angeben einer Instanz: Beispiele
Vorbereitungen
Der erste Knoten, der auf SQLSERVER:\SQL in einem SQL Server-Anbieterpfad folgt, ist der Name des Computers, auf dem die Instanz von Database Engine (Datenbankmodul) ausgeführt wird, z. B.:
SQLSERVER:\SQL\MyComputer
Wenn Sie Windows PowerShell auf demselben Computer ausführen wie die Instanz von Database Engine (Datenbankmodul), 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 Database Engine (Datenbankmodul) 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 Database Engine (Datenbankmodul) aufweisen. 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.
[Nach oben]
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`)\DEFAULTdie Klammer in ihrer hexadezimalen Darstellung codieren:
Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT
[Nach oben]
Siehe auch
Konzepte
SQL Server-Bezeichnern in PowerShell