Bagikan melalui

New-AzureSqlDatabaseServerContext

  • Referensi
Modul:
Azure

Membuat konteks koneksi server.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.

Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.

Sintaks

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

Deskripsi

Cmdlet New-AzureSqlDatabaseServerContext membuat konteks koneksi server Azure SQL Database. Gunakan autentikasi SQL Server untuk membuat konteks koneksi ke server SQL Database dengan menggunakan kredensial yang ditentukan. Anda dapat menentukan server SQL Database berdasarkan nama, dengan nama yang sepenuhnya memenuhi syarat, atau berdasarkan URL. Untuk mendapatkan kredensial, gunakan cmdlet Get-Credential yang meminta Anda untuk menentukan nama pengguna dan kata sandi.

Gunakan cmdlet New-AzureSqlDatabaseServerContext dengan autentikasi berbasis sertifikat untuk membuat konteks koneksi ke server SQL Database yang ditentukan dengan menggunakan data langganan Azure yang ditentukan. Anda dapat menentukan server SQL Database berdasarkan nama atau dengan nama yang sepenuhnya memenuhi syarat. Anda dapat menentukan data langganan sebagai parameter atau dapat diambil dari langganan Azure saat ini. Gunakan cmdlet Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx untuk memilih langganan Azure saat ini.

Contoh

Contoh 1: Membuat konteks dengan menggunakan autentikasi 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"

Contoh ini menggunakan autentikasi SQL Server.

Perintah pertama meminta kredensial administrator server, dan menyimpan kredensial dalam variabel $Credential.

Perintah kedua tersambung ke server SQL Database bernama lpqd0zbr8y dengan menggunakan $Credential.

Perintah akhir membuat database bernama Database17 di server yang merupakan bagian dari konteks dalam $Context.

Contoh 2: Membuat konteks dengan menggunakan autentikasi berbasis sertifikat

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

Contoh ini menggunakan autentikasi berbasis sertifikat.

Dua perintah pertama menetapkan nilai ke variabel $SubscriptionId dan $Thumbprint.

Perintah ketiga mendapatkan sertifikat yang diidentifikasi oleh thumbprint di $Thumbprint, dan menyimpannya di $Certificate.

Perintah keempat mengatur langganan menjadi Subscription07, dan perintah kelima memilih langganan tersebut.

Perintah akhir membuat konteks dalam langganan saat ini untuk server bernama lpqd0zbr8y.

Parameter

-Credential

Menentukan objek kredensial yang menyediakan autentikasi SQL Server bagi Anda untuk mengakses server.

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-FullyQualifiedServerName

Menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) untuk server Azure SQL Database. Misalnya, Server02.database.windows.net.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-ManageUrl

Menentukan URL yang digunakan cmdlet ini untuk mengakses Portal Azure SQL DatabaseManagement untuk server.

Jenis:Uri
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Profile

Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.

Jenis:AzureSMProfile
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServerName

Menentukan nama server database.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-SubscriptionName

Menentukan nama langganan Azure yang digunakan cmdlet ini untuk membuat konteks koneksi. Jika Anda tidak menentukan nilai untuk parameter ini, cmdlet menggunakan langganan saat ini. Jalankan cmdlet Select-AzureSubscription untuk mengubah langganan saat ini.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-UseSubscription

Menunjukkan bahwa cmdlet ini menggunakan langganan Azure untuk membuat konteks koneksi.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

Output

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

Catatan

  • Jika Anda mengautentikasi tanpa menentukan domain, dan jika Anda menggunakan Windows PowerShell 2.0, cmdlet Get-Credential mengembalikan garis miring terbalik (\) yang sebelumnya ditambahkan ke nama pengguna, misalnya, \user. Windows PowerShell 3.0 tidak menambahkan garis miring terbelakang. Garis miring terbalik ini tidak dikenali oleh parameter Kredensial cmdlet New-AzureSqlDatabaseServerContext . Untuk menghapusnya, gunakan perintah yang mirip dengan berikut ini:

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