Udostępnij przez

New-AzureSqlDatabaseServerContext

  • Odwołanie
Moduł:
Azure

Tworzy kontekst połączenia serwera.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API zarządzania usługami. Zobacz moduł Az programu PowerShell, aby uzyskać polecenia cmdlet do zarządzania zasobami usługi Azure Resource Manager.

Składnia

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

Opis

Polecenie cmdlet New-AzureSqlDatabaseServerContext tworzy kontekst połączenia serwera usługi Azure SQL Database. Użyj uwierzytelniania programu SQL Server, aby utworzyć kontekst połączenia z serwerem usługi SQL Database przy użyciu określonych poświadczeń. Serwer usługi SQL Database można określić według nazwy, przez w pełni kwalifikowaną nazwę lub adres URL. Aby uzyskać poświadczenia, użyj polecenia cmdlet Get-Credential z monitem o podanie nazwy użytkownika i hasła.

Użyj polecenia cmdlet New-AzureSqlDatabaseServerContext z uwierzytelnianiem opartym na certyfikatach, aby utworzyć kontekst połączenia z określonym serwerem usługi SQL Database przy użyciu określonych danych subskrypcji platformy Azure. Serwer usługi SQL Database można określić według nazwy lub w pełni kwalifikowanej nazwy. Możesz określić dane subskrypcji jako parametr lub pobrać je z bieżącej subskrypcji platformy Azure. Użyj polecenia cmdlet Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx , aby wybrać bieżącą subskrypcję platformy Azure.

Przykłady

Przykład 1. Tworzenie kontekstu przy użyciu uwierzytelniania programu 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"

W tym przykładzie użyto uwierzytelniania programu SQL Server.

Pierwsze polecenie wyświetla monit o poświadczenia administratora serwera i przechowuje poświadczenia w zmiennej $Credential.

Drugie polecenie łączy się z serwerem usługi SQL Database o nazwie lpqd0zbr8y przy użyciu $Credential.

Ostatnie polecenie tworzy bazę danych o nazwie Database17 na serwerze, który jest częścią kontekstu w $Context.

Przykład 2. Tworzenie kontekstu przy użyciu uwierzytelniania opartego na certyfikatach

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

W tym przykładzie użyto uwierzytelniania opartego na certyfikatach.

Dwa pierwsze polecenia przypisują wartości do zmiennych $SubscriptionId i $Thumbprint.

Trzecie polecenie pobiera certyfikat zidentyfikowany przez odcisk palca w $Thumbprint i przechowuje go w $Certificate.

Czwarte polecenie ustawia subskrypcję na Subscription07, a piąte polecenie wybiera tę subskrypcję.

Końcowe polecenie tworzy kontekst w bieżącej subskrypcji serwera o nazwie lpqd0zbr8y.

Parametry

-Credential

Określa obiekt poświadczeń, który zapewnia uwierzytelnianie programu SQL Server, aby uzyskać dostęp do serwera.

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

-FullyQualifiedServerName

Określa w pełni kwalifikowaną nazwę domeny (FQDN) dla serwera usługi Azure SQL Database. Na przykład Server02.database.windows.net.

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

-ManageUrl

Określa adres URL używany przez to polecenie cmdlet w celu uzyskania dostępu do portalu zarządzania usługą Azure SQL Database dla serwera.

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

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

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

-ServerName

Określa nazwę serwera bazy danych.

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

-SubscriptionName

Określa nazwę subskrypcji platformy Azure, która używa tego polecenia cmdlet do utworzenia kontekstu połączenia. Jeśli nie określisz wartości dla tego parametru, polecenie cmdlet używa bieżącej subskrypcji. Uruchom polecenie cmdlet Select-AzureSubscription, aby zmienić bieżącą subskrypcję.

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

-UseSubscription

Wskazuje, że to polecenie cmdlet używa subskrypcji platformy Azure do tworzenia kontekstu połączenia.

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

Dane wyjściowe

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

Uwagi

  • Jeśli uwierzytelniasz się bez określania domeny, a jeśli używasz programu Windows PowerShell 2.0, polecenie cmdlet Get-Credential zwraca ukośnik odwrotny (\) poprzedzany nazwą użytkownika, na przykład \user. Program Windows PowerShell 3.0 nie dodaje ukośnika odwrotnego. Ten ukośnik odwrotny nie jest rozpoznawany przez parametr Credential polecenia cmdlet New-AzureSqlDatabaseServerContext. Aby go usunąć, użyj poleceń podobnych do następujących:

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