New-AzureSqlDatabaseServerContext

모듈:

Azure

서버 연결 컨텍스트를 만듭니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 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

New-AzureSqlDatabaseServerContext cmdlet은 Azure SQL Database 서버 연결 컨텍스트를 만듭니다. SQL Server 인증을 사용하여 지정된 자격 증명을 사용하여 SQL Database 서버에 대한 연결 컨텍스트를 만듭니다. 이름, 정규화된 이름 또는 URL로 SQL Database 서버를 지정할 수 있습니다. 자격 증명을 가져오려면 사용자 이름 및 암호를 지정하라는 메시지가 표시되는 Get-Credential cmdlet을 사용합니다.

인증서 기반 인증과 함께 New-AzureSqlDatabaseServerContext cmdlet을 사용하여 지정된 Azure 구독 데이터를 사용하여 지정된 SQL Database 서버에 대한 연결 컨텍스트를 만듭니다. 이름 또는 정규화된 이름으로 SQL Database 서버를 지정할 수 있습니다. 구독 데이터를 매개 변수로 지정하거나 현재 Azure 구독에서 검색할 수 있습니다. Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx cmdlet을 사용하여 현재 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 변수에 저장합니다.

두 번째 명령은 $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

이 예제에서는 인증서 기반 인증을 사용합니다.

처음 두 명령은 $SubscriptionId 및 $Thumbprint 변수에 값을 할당합니다.

세 번째 명령은 $Thumbprint 지문으로 식별된 인증서를 가져오고 $Certificate 저장합니다.

네 번째 명령은 구독을 Subscription07로 설정하고 다섯 번째 명령은 해당 구독을 선택합니다.

최종 명령은 lpqd0zbr8y라는 서버에 대한 현재 구독에 컨텍스트를 만듭니다.

매개 변수

-Credential

서버에 액세스할 수 있도록 SQL Server 인증을 제공하는 자격 증명 개체를 지정합니다.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FullyQualifiedServerName

Azure SQL Database 서버의 FQDN(정규화된 도메인 이름) 이름을 지정합니다. 예를 들어 Server02.database.windows.net.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ManageUrl

이 cmdlet이 서버에 대한 Azure SQL DatabaseManagement 포털에 액세스하는 데 사용하는 URL을 지정합니다.

Type:	Uri
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

데이터베이스 서버의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SubscriptionName

이 cmdlet이 연결 컨텍스트를 만드는 데 사용하는 Azure 구독의 이름을 지정합니다. 이 매개 변수의 값을 지정하지 않으면 cmdlet은 현재 구독을 사용합니다. Select-AzureSubscription cmdlet을 실행하여 현재 구독을 변경합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UseSubscription

이 cmdlet은 연결 컨텍스트를 만들기 위해 Azure 구독을 사용한다는 것을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

출력

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

참고

• 도메인을 지정하지 않고 인증하고 Windows PowerShell 2.0을 사용하는 경우 Get-Credential cmdlet은 사용자 이름 앞에 백슬래시(\)를 반환합니다(예: \user). Windows PowerShell 3.0은 백슬래시를 추가하지 않습니다. 이 백슬래시는 New-AzureSqlDatabaseServerContext cmdlet의 자격 증명 매개 변수에 의해 인식되지 않습니다. 제거하려면 다음과 유사한 명령을 사용합니다.

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

관련 링크

• Get-AzureSqlDatabase
• New-AzureSqlDatabase
• Remove-AzureSqlDatabase
• Set-AzureSqlDatabase