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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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-Datenbankserververbindungskontext. Verwenden Sie die SQL Server-Authentifizierung, um mithilfe der angegebenen Anmeldeinformationen einen Verbindungskontext mit einem SQL-Datenbankserver zu erstellen. Sie können den SQL-Datenbankserver 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-Datenbankserver zu erstellen. Sie können SQL-Datenbankserver nach Namen 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-Datenbankserver 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.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FullyQualifiedServerName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ManageUrl

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

Type:	Uri
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

Gibt den Namen des Datenbankservers an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UseSubscription

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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