Dela via

New-AzureSqlDatabaseServerContext

  • Referens
Modul:
Azure

Skapar en serveranslutningskontext.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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

Description

Cmdleten New-AzureSqlDatabaseServerContext skapar en Azure SQL Database-serveranslutningskontext. Använd SQL Server-autentisering för att skapa en anslutningskontext till en SQL Database-server med hjälp av de angivna autentiseringsuppgifterna. Du kan ange SQL Database-servern efter namn, med det fullständigt kvalificerade namnet eller efter URL. Om du vill hämta en autentiseringsuppgift använder du cmdleten Get-Credential som uppmanar dig att ange användarnamn och lösenord.

Använd cmdleten New-AzureSqlDatabaseServerContext med certifikatbaserad autentisering för att skapa en anslutningskontext till den angivna SQL Database-servern med hjälp av angivna Azure-prenumerationsdata. Du kan ange SQL Database-servern efter namn eller med det fullständigt kvalificerade namnet. Du kan ange prenumerationsdata som en parameter eller hämta dem från den aktuella Azure-prenumerationen. Använd cmdleten Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx för att välja den aktuella Azure-prenumerationen.

Exempel

Exempel 1: Skapa en kontext med hjälp av SQL Server-autentisering

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"

I det här exemplet används SQL Server-autentisering.

Det första kommandot frågar efter autentiseringsuppgifter för serveradministratör och lagrar autentiseringsuppgifterna i variabeln $Credential.

Det andra kommandot ansluter till SQL Database-servern med namnet lpqd0zbr8y med hjälp av $Credential.

Det sista kommandot skapar en databas med namnet Database17 på servern som ingår i kontexten i $Context.

Exempel 2: Skapa en kontext med hjälp av certifikatbaserad autentisering

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

I det här exemplet används den certifikatbaserade autentiseringen.

De två första kommandona tilldelar värden till variablerna $SubscriptionId och $Thumbprint.

Det tredje kommandot hämtar certifikatet som identifieras av tumavtrycket i $Thumbprint och lagrar det i $Certificate.

Det fjärde kommandot anger prenumerationen till Subscription07 och det femte kommandot väljer den prenumerationen.

Det sista kommandot skapar en kontext i den aktuella prenumerationen för servern med namnet lpqd0zbr8y.

Parametrar

-Credential

Anger ett autentiseringsobjekt som tillhandahåller SQL Server-autentisering så att du kan komma åt servern.

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

-FullyQualifiedServerName

Anger det fullständigt kvalificerade domännamnet (FQDN) för Azure SQL Database-servern. Till exempel Server02.database.windows.net.

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

-ManageUrl

Anger den URL som den här cmdleten använder för att komma åt Azure SQL DatabaseManagement-portalen för servern.

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

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

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

-ServerName

Anger namnet på databasservern.

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

-SubscriptionName

Anger namnet på den Azure-prenumeration som den här cmdleten använder för att skapa anslutningskontexten. Om du inte anger något värde för den här parametern använder cmdleten den aktuella prenumerationen. Kör cmdleten Select-AzureSubscription för att ändra den aktuella prenumerationen.

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

-UseSubscription

Anger att den här cmdleten använder Azure-prenumerationen för att skapa anslutningskontexten.

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

Utdata

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

Kommentarer

  • Om du autentiserar utan att ange en domän, och om du använder Windows PowerShell 2.0, returnerar cmdleten Get-Credential ett omvänt snedstreck (\) som är förberett för användarnamnet, till exempel \user. Windows PowerShell 3.0 lägger inte till omvänt snedstreck. Det här omvänt snedstrecket känns inte igen av parametern Credential i cmdleten New-AzureSqlDatabaseServerContext . Om du vill ta bort den använder du kommandon som liknar följande:

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