Delen via

New-AzureSqlDatabaseServerContext

  • Referentie
Module:
Azure

Hiermee maakt u een serververbindingscontext.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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>]

Description

Met de cmdlet New-AzureSqlDatabaseServerContext maakt u een azure SQL Database-serververbindingscontext. Gebruik SQL Server-verificatie om een verbindingscontext te maken met een SQL Database-server met behulp van de opgegeven referenties. U kunt de SQL Database-server opgeven op naam, op basis van de volledig gekwalificeerde naam of op URL. Als u een referentie wilt verkrijgen, gebruikt u de cmdlet Get-Credential waarmee u wordt gevraagd om de gebruikersnaam en het wachtwoord op te geven.

Gebruik de cmdlet New-AzureSqlDatabaseServerContext met verificatie op basis van certificaten om een verbindingscontext te maken met de opgegeven SQL Database-server met behulp van de opgegeven Azure-abonnementsgegevens. U kunt sql Database-server opgeven op naam of op basis van de volledig gekwalificeerde naam. U kunt de abonnementsgegevens opgeven als parameter of kunnen worden opgehaald uit het huidige Azure-abonnement. Gebruik de cmdlet Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx om het huidige Azure-abonnement te selecteren.

Voorbeelden

Voorbeeld 1: Een context maken met behulp van SQL Server-verificatie

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 dit voorbeeld wordt de SQL Server-verificatie gebruikt.

De eerste opdracht vraagt u om de referenties van de serverbeheerder en slaat de referenties op in de $Credential variabele.

De tweede opdracht maakt verbinding met de SQL Database-server met de naam lpqd0zbr8y met behulp van $Credential.

Met de laatste opdracht maakt u een database met de naam Database17 op de server die deel uitmaakt van de context in $Context.

Voorbeeld 2: Een context maken met behulp van verificatie op basis van certificaten

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 dit voorbeeld wordt gebruikgemaakt van verificatie op basis van certificaten.

Met de eerste twee opdrachten worden waarden toegewezen aan de $SubscriptionId en $Thumbprint variabelen.

Met de derde opdracht wordt het certificaat opgehaald dat wordt geïdentificeerd door de vingerafdruk in $Thumbprint en opgeslagen in $Certificate.

Met de vierde opdracht wordt het abonnement ingesteld op Subscription07 en met de vijfde opdracht wordt dat abonnement geselecteerd.

Met de laatste opdracht maakt u een context in het huidige abonnement voor de server met de naam lpqd0zbr8y.

Parameters

-Credential

Hiermee geeft u een referentieobject op dat SQL Server-verificatie biedt voor toegang tot de server.

Type:PSCredential
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FullyQualifiedServerName

Hiermee geeft u de FQDN-naam (Fully Qualified Domain Name) op voor de Azure SQL Database-server. Bijvoorbeeld Server02.database.windows.net.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ManageUrl

Hiermee geeft u de URL op die door deze cmdlet wordt gebruikt voor toegang tot de Azure SQL DatabaseManagement-portal voor de server.

Type:Uri
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerName

Hiermee geeft u de naam van de databaseserver.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SubscriptionName

Hiermee geeft u de naam op van het Azure-abonnement dat door deze cmdlet wordt gebruikt om de verbindingscontext te maken. Als u geen waarde voor deze parameter opgeeft, gebruikt de cmdlet het huidige abonnement. Voer de cmdlet Select-AzureSubscription uit om het huidige abonnement te wijzigen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UseSubscription

Geeft aan dat deze cmdlet gebruikmaakt van een Azure-abonnement voor het maken van de verbindingscontext.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

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

Notities

  • Als u zich verifieert zonder een domein op te geven en als u Windows PowerShell 2.0 gebruikt, retourneert de cmdlet Get-Credential een backslash (\) die is voorafgegaan aan de gebruikersnaam, bijvoorbeeld \gebruiker. Windows PowerShell 3.0 voegt de backslash niet toe. Deze backslash wordt niet herkend door de referentieparameter van de cmdlet New-AzureSqlDatabaseServerContext . Als u deze wilt verwijderen, gebruikt u opdrachten die vergelijkbaar zijn met de volgende:

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