Freigeben über

New-AzureSqlDatabaseServerContext

  • Referenz
Modul:
Azure

Erstellt einen Serververbindungskontext.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

New-AzureSqlDatabaseServerContext
   -ServerName <String>
   -Credential <PSCredential>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureSqlDatabaseServerContext
   [-ServerName <String>]
   -ManageUrl <Uri>
   -Credential <PSCredential>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureSqlDatabaseServerContext
   -ServerName <String>
   [-UseSubscription]
   [-SubscriptionName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureSqlDatabaseServerContext
   -FullyQualifiedServerName <String>
   -Credential <PSCredential>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureSqlDatabaseServerContext
   -FullyQualifiedServerName <String>
   [-UseSubscription]
   [-SubscriptionName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureSqlDatabaseServerContext erstellt einen Azure SQL-Datenbank Serververbindungskontext. Verwenden Sie die SQL Server-Authentifizierung, um mithilfe der angegebenen Anmeldeinformationen einen Verbindungskontext mit einem SQL-Datenbank Server zu erstellen. Sie können den SQL-Datenbank Server anhand des Namens, des vollqualifizierten Namens oder der URL angeben. Verwenden Sie zum Abrufen von Anmeldeinformationen das Cmdlet "Get-Credential", das Sie auffordert, den Benutzernamen und das Kennwort anzugeben.

Verwenden Sie das Cmdlet New-AzureSqlDatabaseServerContext mit zertifikatbasierter Authentifizierung, um mithilfe der angegebenen Azure-Abonnementdaten einen Verbindungskontext mit dem angegebenen SQL-Datenbank Server zu erstellen. Sie können SQL-Datenbank Server anhand des Namens oder durch den vollqualifizierten Namen angeben. Sie können die Abonnementdaten als Parameter angeben oder aus dem aktuellen Azure-Abonnement abrufen. Verwenden Sie das Cmdlet Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx , um das aktuelle Azure-Abonnement auszuwählen.

Beispiele

Beispiel 1: Erstellen eines Kontexts mithilfe der SQL Server-Authentifizierung

PS C:\> $Credential = Get-Credential
PS C:\> $Context = New-AzureSqlDatabaseServerContext -ServerName "lpqd0zbr8y" -Credential $Credential
PS C:\> $Database17 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database17" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

In diesem Beispiel wird die SQL Server-Authentifizierung verwendet.

Die erste Eingabeaufforderung fordert Sie zur Eingabe von Serveradministratoranmeldeinformationen auf und speichert die Anmeldeinformationen in der variablen $Credential.

Der zweite Befehl stellt mithilfe von $Credential eine Verbindung mit dem SQL-Datenbank Server mit dem Namen lpqd0zbr8y bereit.

Mit dem letzten Befehl wird eine Datenbank namens "Database17" auf dem Server erstellt, die Teil des Kontexts in $Context ist.

Beispiel 2: Erstellen eines Kontexts mithilfe der zertifikatbasierten Authentifizierung

PS C:\> $SubscriptionId = <Subscription ID>
PS C:\> $Thumbprint = <Certificate Thumbprint>
PS C:\> $Certificate = Get-Item "Cert:\CurrentUser\My\$Thumbprint"
PS C:\> Set-AzureSubscription -SubscriptionName "Subscription07" -SubscriptionId $SubscriptionId -Certificate $Certificate
PS C:\> Select-AzureSubscription -SubscriptionName "Subscription07"
PS C:\> $Context = New-AzureSqlDatabaseServerContext -ServerName "lpqd0zbr8y" -UseSubscription

In diesem Beispiel wird die zertifikatbasierte Authentifizierung verwendet.

Die ersten beiden Befehle weisen den variablen $SubscriptionId und $Thumbprint Werte zu.

Der dritte Befehl ruft das durch den Fingerabdruck in $Thumbprint identifizierte Zertifikat ab und speichert es in $Certificate.

Mit dem vierten Befehl wird das Abonnement auf "Subscription07" festgelegt, und der fünfte Befehl wählt dieses Abonnement aus.

Der letzte Befehl erstellt einen Kontext im aktuellen Abonnement für den Server mit dem Namen lpqd0zbr8y.

Parameter

-Credential

Gibt ein Anmeldeinformationsobjekt an, das SQL Server-Authentifizierung für den Zugriff auf den Server bereitstellt.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FullyQualifiedServerName

Gibt den vollqualifizierten Domänennamen (FQDN) für den Azure SQL-Datenbank-Server an. Beispiel: Server02.database.windows.net.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManageUrl

Gibt die URL an, die dieses Cmdlet für den Zugriff auf das Azure SQL-Datenbank Management Portal für den Server verwendet.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerName

Gibt den Namen des Datenbankservers an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SubscriptionName

Gibt den Namen des Azure-Abonnements an, das dieses Cmdlet zum Erstellen des Verbindungskontexts verwendet. Wenn Sie keinen Wert für diesen Parameter angeben, verwendet das Cmdlet das aktuelle Abonnement. Führen Sie das Cmdlet Select-AzureSubscription aus, um das aktuelle Abonnement zu ändern.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UseSubscription

Gibt an, dass dieses Cmdlet das Azure-Abonnement zum Erstellen des Verbindungskontexts verwendet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.IServerDataServiceContext

Hinweise

  • Wenn Sie sich authentifizieren, ohne eine Domäne anzugeben, und wenn Sie Windows PowerShell 2.0 verwenden, gibt das Cmdlet "Get-Credential" einen umgekehrten Schrägstrich (\) zurück, der dem Benutzernamen vorangestellt ist, z. B. \benutzer. Windows PowerShell 3.0 fügt den umgekehrten Schrägstrich nicht hinzu. Dieser umgekehrte Schrägstrich wird vom Parameter "Credential " des Cmdlets New-AzureSqlDatabaseServerContext nicht erkannt. Verwenden Sie zum Entfernen Befehle wie die folgenden:

    PS C:\\\> $Credential = Get-Credential PS C:\\\> $Credential = New-Object -TypeName 'System.Management.Automation.PSCredential' -ArgumentList $Credential.Username.Replace("\",""),$Credential.Password