New-AzureSqlDatabaseServerContext

サーバー接続コンテキストを作成します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

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

説明

New-AzureSqlDatabaseServerContext コマンドレットは、Azure SQL Database サーバー接続コンテキストを作成します。 SQL Server 認証を使用して、指定された資格情報を使用して SQL Database サーバーへの接続コンテキストを作成します。 SQL Database サーバーは、名前、完全修飾名、または URL で指定できます。 資格情報を取得するには、ユーザー名とパスワードの指定を求める Get-Credential コマンドレットを使用します。

証明書ベースの 認証で New-AzureSqlDatabaseServerContext コマンドレットを使用し、指定した Azure サブスクリプション データを使用して、指定した SQL Database サーバーへの接続コンテキストを作成します。 SQL Database サーバーは、名前または完全修飾名で指定できます。 サブスクリプション データをパラメーターとして指定することも、現在の Azure サブスクリプションから取得することもできます。 Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx コマンドレットを使用して、現在の Azure サブスクリプションを選択します。

例 1: 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"

この例では、SQL Server 認証を使用します。

最初のコマンドでは、サーバー管理者の資格情報の入力を求め、資格情報を $Credential 変数に格納します。

2 番目のコマンドは、$Credentialを使用して lpqd0zbr8y という名前の SQL Database サーバーに接続します。

最後のコマンドは、$Contextのコンテキストの一部であるデータベース Database17 をサーバー上に作成します。

例 2: 証明書ベースの認証を使用してコンテキストを作成する

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

この例では、証明書ベースの認証を使用します。

最初の 2 つのコマンドは、$SubscriptionId変数と$Thumbprint変数に値を割り当てます。

3 番目のコマンドは、$Thumbprintの拇印によって識別された証明書を取得し、$Certificateに格納します。

4 番目のコマンドはサブスクリプションを Subscription07 に設定し、5 番目のコマンドはそのサブスクリプションを選択します。

最後のコマンドは、lpqd0zbr8y という名前のサーバーの現在のサブスクリプションにコンテキストを作成します。

パラメーター

-Credential

サーバーにアクセスするための SQL Server 認証を提供する資格情報オブジェクトを指定します。

型:PSCredential
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FullyQualifiedServerName

Azure SQL Database サーバーの完全修飾ドメイン名 (FQDN) 名を指定します。 たとえば、Server02.database.windows.net。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ManageUrl

このコマンドレットがサーバーの Azure SQL DatabaseManagement ポータルにアクセスするために使用する URL を指定します。

型:Uri
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerName

データベース サーバーの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SubscriptionName

このコマンドレットが接続コンテキストの作成に使用する Azure サブスクリプションの名前を指定します。 このパラメーターの値を指定しない場合、コマンドレットは現在のサブスクリプションを使用します。 Select-AzureSubscription コマンドレットを実行して、現在のサブスクリプションを変更します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-UseSubscription

このコマンドレットが Azure サブスクリプションを使用して接続コンテキストを作成することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

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

メモ

  • ドメインを指定せずに認証し、Windows PowerShell 2.0 を使用する場合、Get-Credential コマンドレットはユーザー名の前に円記号 (\) (\user など) を返します。 Windows PowerShell 3.0 では円記号は追加されません。 この円記号は、New-AzureSqlDatabaseServerContext コマンドレットの Credential パラメーターでは認識されません。 削除するには、次のようなコマンドを使用します。

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