Sdílet prostřednictvím

New-AzureSqlDatabaseServerContext

  • Reference
Modul:
Azure

Vytvoří kontext připojení k serveru.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Rutina New-AzureSqlDatabaseServerContext vytvoří kontext připojení serveru Azure SQL Database. Pomocí ověřování SQL Serveru vytvořte kontext připojení k serveru služby SQL Database pomocí zadaných přihlašovacích údajů. Server služby SQL Database můžete zadat podle názvu, plně kvalifikovaného názvu nebo adresy URL. Pokud chcete získat přihlašovací údaje, použijte rutinu Get-Credential, která vás vyzve k zadání uživatelského jména a hesla.

Pomocí rutiny New-AzureSqlDatabaseServerContext s ověřováním na základě certifikátů vytvořte kontext připojení k zadanému serveru služby SQL Database pomocí zadaných dat předplatného Azure. Server služby SQL Database můžete zadat podle názvu nebo plně kvalifikovaného názvu. Data předplatného můžete zadat jako parametr nebo je můžete načíst z aktuálního předplatného Azure. Pomocí rutiny Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx vyberte aktuální předplatné Azure.

Příklady

Příklad 1: Vytvoření kontextu pomocí ověřování SQL Serveru

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"

V tomto příkladu se používá ověřování SQL Serveru.

První příkaz vás vyzve k zadání přihlašovacích údajů správce serveru a uloží přihlašovací údaje do proměnné $Credential.

Druhý příkaz se připojí k serveru služby SQL Database s názvem lpqd0zbr8y pomocí $Credential.

Poslední příkaz vytvoří databázi s názvem Database17 na serveru, který je součástí kontextu v $Context.

Příklad 2: Vytvoření kontextu pomocí ověřování na základě certifikátů

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

V tomto příkladu se používá ověřování na základě certifikátů.

První dva příkazy přiřazují hodnoty $SubscriptionId a $Thumbprint proměnným.

Třetí příkaz získá certifikát identifikovaný kryptografickým otiskem v $Thumbprint a uloží ho do $Certificate.

Čtvrtý příkaz nastaví předplatné na Subscription07 a pátý příkaz toto předplatné vybere.

Poslední příkaz vytvoří kontext v aktuálním předplatném pro server s názvem lpqd0zbr8y.

Parametry

-Credential

Určuje objekt přihlašovacích údajů, který poskytuje ověřování SQL Serveru pro přístup k serveru.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FullyQualifiedServerName

Určuje plně kvalifikovaný název domény (FQDN) pro server služby Azure SQL Database. Například Server02.database.windows.net.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ManageUrl

Určuje adresu URL, kterou tato rutina používá pro přístup k portálu Azure SQL DatabaseManagement pro server.

Typ:Uri
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerName

Určuje název databázového serveru.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SubscriptionName

Určuje název předplatného Azure, které tato rutina používá k vytvoření kontextu připojení. Pokud nezadáte hodnotu pro tento parametr, rutina použije aktuální předplatné. Spuštěním rutiny Select-AzureSubscription změňte aktuální předplatné.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UseSubscription

Označuje, že tato rutina používá předplatné Azure k vytvoření kontextu připojení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

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

Poznámky

  • Pokud se ověřujete bez zadání domény a pokud používáte Windows PowerShell 2.0, rutina Get-Credential vrátí zpětné lomítko (\) předpřipravené uživatelské jméno, například \user. Windows PowerShell 3.0 nepřidá zpětné lomítko. Toto zpětné lomítko nerozpozná parametr Credential rutiny New-AzureSqlDatabaseServerContext . Pokud ho chcete odebrat, použijte příkazy podobné následujícímu:

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