Partager via

New-AzureSqlDatabaseServerContext

  • Référence
Module:
Azure

Crée un contexte de connexion de serveur.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

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

L’applet de commande New-AzureSqlDatabaseServerContext crée un contexte de connexion de serveur Azure SQL Database. Utilisez l’authentification SQL Server pour créer un contexte de connexion à un serveur SQL Database à l’aide des informations d’identification spécifiées. Vous pouvez spécifier le serveur SQL Database par nom, par nom, par nom complet ou par URL. Pour obtenir des informations d’identification, utilisez l’applet de commande Get-Credential qui vous invite à spécifier le nom d’utilisateur et le mot de passe.

Utilisez l’applet de commande New-AzureSqlDatabaseServerContext avec l’authentification basée sur un certificat pour créer un contexte de connexion au serveur SQL Database spécifié à l’aide des données d’abonnement Azure spécifiées. Vous pouvez spécifier le serveur SQL Database par nom ou par le nom complet. Vous pouvez spécifier les données d’abonnement en tant que paramètre ou être récupérées à partir de l’abonnement Azure actuel. Utilisez l’applet de commande Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx pour sélectionner l’abonnement Azure actuel.

Exemples

Exemple 1 : Créer un contexte à l’aide de l’authentification SQL Server

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"

Cet exemple utilise l’authentification SQL Server.

La première commande vous invite à entrer les informations d’identification de l’administrateur du serveur et stocke les informations d’identification dans la variable $Credential.

La deuxième commande se connecte au serveur SQL Database nommé lpqd0zbr8y à l’aide de $Credential.

La commande finale crée une base de données nommée Database17 sur le serveur qui fait partie du contexte dans $Context.

Exemple 2 : Créer un contexte à l’aide de l’authentification basée sur des certificats

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

Cet exemple utilise l’authentification basée sur les certificats.

Les deux premières commandes attribuent des valeurs aux variables $SubscriptionId et $Thumbprint.

La troisième commande obtient le certificat identifié par l’empreinte numérique dans $Thumbprint et le stocke dans $Certificate.

La quatrième commande définit l’abonnement sur Subscription07, et la cinquième commande sélectionne cet abonnement.

La commande finale crée un contexte dans l’abonnement actuel pour le serveur nommé lpqd0zbr8y.

Paramètres

-Credential

Spécifie un objet d’informations d’identification qui fournit l’authentification SQL Server pour vous permettre d’accéder au serveur.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FullyQualifiedServerName

Spécifie le nom de domaine complet (FQDN) du serveur Azure SQL Database. Par exemple, Server02.database.windows.net.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManageUrl

Spécifie l’URL utilisée par cette applet de commande pour accéder au portail Azure SQL DatabaseManagement pour le serveur.

Type:Uri
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerName

Spécifie le nom du serveur de base de données.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SubscriptionName

Spécifie le nom de l’abonnement Azure que cette applet de commande utilise pour créer le contexte de connexion. Si vous ne spécifiez pas de valeur pour ce paramètre, l’applet de commande utilise l’abonnement actuel. Exécutez l’applet de commande Select-AzureSubscription pour modifier l’abonnement actuel.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-UseSubscription

Indique que cette applet de commande utilise l’abonnement Azure pour créer le contexte de connexion.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

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

Notes

  • Si vous vous authentifiez sans spécifier de domaine et si vous utilisez Windows PowerShell 2.0, l’applet de commande Get-Credential retourne une barre oblique inverse (\) ajoutée au nom d’utilisateur, par exemple\ user. Windows PowerShell 3.0 n’ajoute pas la barre oblique inverse. Cette barre oblique inverse n’est pas reconnue par le paramètre Credential de l’applet de commande New-AzureSqlDatabaseServerContext . Pour le supprimer, utilisez des commandes similaires à ce qui suit :

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