New-AzureSqlDatabaseServerContext

  • Référence
Module:
Azure

Crée un contexte de connexion de serveur.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

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

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

-ServerName

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

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

-UseSubscription

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

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