New-ConnStr

EulandaXtools — Funktionsreferenz

New-ConnStr

ÜBERSICHT

Erzeugt einen Connection-String für SQL Server über SQLOLEDB oder MSOLEDBSQL Provider.

SYNTAX

New-ConnStr [[-Provider] <string>] [[-Database] <string>] [[-Server] <string>] [[-Instance]
    <string>] [[-User] <string>] [[-Password] <string>] [<CommonParameters>]

BESCHREIBUNG

Die Funktion erstellt einen OLEDB-Connection-String für den Zugriff auf eine SQL Server-Datenbank. Unterstützt integrierte Windows-Authentifizierung oder SQL-Login (User/Password).

Bei Angabe einer Instanz wird diese nur verwendet, wenn der Serverparameter keinen Backslash enthält. Für den modernen MSOLEDBSQL-Provider werden zusätzliche Parameter wie "Trust Server Certificate" ergänzt.

PARAMETER

-Provider

Type: string
Default: 'SQLOLEDB'

OLEDB-Provider, entweder 'SQLOLEDB' (klassisch) oder 'MSOLEDBSQL' (modern). Standard ist 'SQLOLEDB'.

-Database

Type: string
Default: 'master'

Name der Ziel-Datenbank (Default: 'master').

-Server

Type: string
Default: '.'

Name oder IP des SQL-Servers. Optional mit Instanz im Format 'Server\Instance'. Standard: '.' (lokaler Server).

-Instance

Type: string
Default: ''

Optionaler Instanzname. Wird nur verwendet, wenn -Server keinen Backslash enthält.

-User

Type: string

Benutzername für SQL-Authentifizierung. Wenn leer, wird Windows-Authentifizierung verwendet.

-Password

Type: string

Passwort für SQL-Authentifizierung. Nur relevant, wenn -User gesetzt ist.

BEISPIELE

# Erzeugt einen Connection-String mit Windows-Authentifizierung für STUDIO\SQL2019 und Datenbank "EULANDA_MUSTERMANN".
New-ConnStr -Server "STUDIO" -Instance "SQL2019" -Database "EULANDA_MUSTERMANN"

# Ausgabe:
# Provider=SQLOLEDB.1;Data Source=STUDIO\SQL2019;Initial Catalog=EULANDA_MUSTERMANN;
#   Integrated Security=SSPI
# Erzeugt einen Connection-String mit MSOLEDBSQL und SQL-Login.
New-ConnStr -Provider MSOLEDBSQL -Server "STUDIO" -Database "EULANDA_MUSTERMANN" `
            -User "eulanda" -Password "geheim123"

# Ausgabe:
# Provider=MSOLEDBSQL.1;Data Source=STUDIO;Initial Catalog=EULANDA_MUSTERMANN;
#   Persist Security Info=True;User ID=eulanda;Password=geheim123;Trust Server Certificate=True;
#   Initial File Name="";Server SPN="";Authentication="";Access Token=""

VERWANDTE LINKS

Get-Conn

HINWEISE

Gibt den vollständigen Connection-String als String zurück.