Udostępnij przez

New-AzSqlDatabaseExport

Moduł:
Az.Sql Module

Eksportuje bazę danych Azure SQL Database jako plik bacpac do konta magazynu.

Składnia

Default (Domyślne) 

New-AzSqlDatabaseExport
    [-DatabaseName] <String>
    [-ServerName] <String>
    -StorageKeyType <StorageKeyType>
    -StorageKey <String>
    -StorageUri <Uri>
    -AdministratorLogin <String>
    -AdministratorLoginPassword <SecureString>
    [-AuthenticationType <AuthenticationType>]
    [-UseNetworkIsolation <Boolean>]
    [-StorageAccountResourceIdForPrivateLink <String>]
    [-SqlServerResourceIdForPrivateLink <String>]
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet New-AzSqlDatabaseExport eksportuje bazę danych Azure SQL Database jako plik bacpac do konta magazynu. Żądanie stanu bazy danych get export może zostać wysłane w celu pobrania informacji o stanie dla tego żądania. To polecenie cmdlet jest również obsługiwane przez usługę SQL Server Stretch Database na platformie Azure.

Ważne

Aby można było korzystać z tego polecenia cmdlet, należy skonfigurować zaporę w programie Azure SQL Server pod kątem ustawienia "Zezwalaj usługom i zasobom platformy Azure na dostęp do tego serwera". Jeśli ta konfiguracja nie zostanie skonfigurowana, wystąpią błędy GatewayTimeout. Nie jest to wymagane, jeśli połączenie usługi Private Link zostanie nawiązane za pośrednictwem parametru UseNetworkIsolation.

Przykłady

Przykład 1. Tworzenie żądania eksportu dla bazy danych

New-AzSqlDatabaseExport -ResourceGroupName "RG01" -ServerName "Server01" -DatabaseName "Database01" -StorageKeyType "StorageAccessKey" -StorageKey "StorageKey01" -StorageUri "http://account01.blob.core.contoso.net/bacpacs/database01.bacpac" -AdministratorLogin "User" -AdministratorLoginPassword "secure password"

ResourceGroupName          : RG01
ServerName                 : Server01
DatabaseName               : Database01
StorageKeyType             : StorageAccessKey
StorageKey                 :
StorageUri                 : http://account01.blob.core.contoso.net/bacpacs/database01.bacpac
AdministratorLogin         : User
AdministratorLoginPassword :
AuthenticationType         : None
OperationStatusLink        : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource01/providers/Microsoft.Sql/servers/server01/databases/database01/importExportOperationResults/00000000-00
                             0-0000-0000-000000000000?api-version=2014-04-01
Status                     : InProgress
ErrorMessage               :

To polecenie tworzy żądanie eksportu dla określonej bazy danych.

Przykład 2. Tworzenie żądania eksportu dla bazy danych przy użyciu tożsamości zarządzanej na potrzeby uwierzytelniania za pośrednictwem łącza prywatnego

$sqlServerName = "Server01"
$storageAccountName = "storageaccount1"
$subscriptionId = "00000000-0000-0000-0000-000000000000"
$resourceGroup = "RG01"
$managedIdentityResourceId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-managed-identity"
$pw = ConvertTo-SecureString "******" -AsPlainText -Force
New-AzSqlDatabaseExport `
    -ResourceGroupName $resourceGroup `
    -ServerName $sqlServerName `
    -DatabaseName "Database01" `
    -StorageKeyType ManagedIdentity `
    -StorageKey $managedIdentityResourceId `
    -StorageUri "https://storageaccount1.blob.core.windows.net/container1/my-file-name.bacpac" `
    -AuthenticationType ManagedIdentity `
    -AdministratorLogin $managedIdentityResourceId `
    -AdministratorLoginPassword $pw `
    -UseNetworkIsolation $true `
    -SqlServerResourceIdForPrivateLink "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Sql/servers/$sqlServerName" `
    -StorageAccountResourceIdForPrivateLink "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

To polecenie tworzy żądanie eksportu dla określonej bazy danych przy użyciu tożsamości zarządzanej do uwierzytelniania z łącznością za pośrednictwem usługi Private Link.

Parametry

-AdministratorLogin

Określa nazwę administratora SQL.

Jeśli -AuthenticationType ManagedIdentity zostanie podana, powinien to być pełny identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika, która jest administratorem firmy Microsoft Entra serwera.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-AdministratorLoginPassword

Określa hasło administratora SQL.

Właściwości parametrów

Typ:SecureString
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-AuthenticationType

Określa typ uwierzytelniania używanego do uzyskiwania dostępu do serwera. Wartość domyślna to SQL, jeśli nie ustawiono żadnego typu uwierzytelniania. Dopuszczalne wartości tego parametru to:

  • SQL. Uwierzytelnianie SQL. Ustaw wartość AdministratorLogin i AdministratorLoginPassword na nazwę użytkownika i hasło administratora SQL.
  • ADPassword. Uwierzytelnianie Microsoft Entra. Ustaw wartość AdministratorLogin i AdministratorLoginPassword na nazwę użytkownika i hasło administratora firmy Microsoft Entra. Ten parametr jest dostępny tylko na serwerach usługi SQL Database w wersji 12.
  • ManagedIdentity. Uwierzytelnianie tożsamości zarządzanej. Użyj tożsamości zarządzanej przypisanej przez użytkownika do uwierzytelniania za pomocą programu SQL Server. Tożsamość zarządzana musi być administratorem firmy Microsoft Entra dla serwera.

Właściwości parametrów

Typ:AuthenticationType
Wartość domyślna:None
Akceptowane wartości:None, Sql, AdPassword, ManagedIdentity
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DatabaseName

Określa nazwę usługi SQL Database.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:2
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

Określa nazwę grupy zasobów dla serwera usługi SQL Database.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ServerName

Określa nazwę serwera usługi SQL Database.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-SqlServerResourceIdForPrivateLink

Identyfikator zasobu programu SQL Server do utworzenia łącza prywatnego

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-StorageAccountResourceIdForPrivateLink

Identyfikator zasobu konta magazynu do utworzenia łącza prywatnego

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-StorageKey

Określa klucz dostępu dla konta magazynu.

Po -StorageKeyType ManagedIdentity podaniu powinien to być pełny identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika, która ma dostęp do zapisu na koncie magazynu dla podanego identyfikatora StorageUri (na przykład za pośrednictwem przypisania roli Współautor danych obiektu blob usługi Storage ).

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-StorageKeyType

Określa typ klucza dostępu dla konta magazynu. Dopuszczalne wartości tego parametru to:

  • StorageAccessKey. Ta wartość używa klucza konta magazynu.
  • SharedAccessKey. Ta wartość używa klucza sygnatury dostępu współdzielonego (SAS).
  • ManagedIdentity. Użyj tożsamości zarządzanej przypisanej przez użytkownika do uwierzytelniania przy użyciu konta magazynu.

Właściwości parametrów

Typ:StorageKeyType
Wartość domyślna:None
Akceptowane wartości:StorageAccessKey, SharedAccessKey, ManagedIdentity
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-StorageUri

Polecenie cmdlet New-AzSqlDatabaseExport eksportuje bazę danych Azure SQL Database jako plik bacpac do konta magazynu. Żądanie stanu bazy danych get export może zostać wysłane w celu pobrania informacji o stanie dla tego żądania. To polecenie cmdlet jest również obsługiwane przez usługę SQL Server Stretch Database na platformie Azure.

Ważne

Aby można było korzystać z tego polecenia cmdlet, należy skonfigurować zaporę w programie Azure SQL Server pod kątem ustawienia "Zezwalaj usługom i zasobom platformy Azure na dostęp do tego serwera". Jeśli ta konfiguracja nie zostanie skonfigurowana, wystąpią błędy GatewayTimeout. Nie jest to wymagane, jeśli połączenie usługi Private Link zostanie nawiązane za pośrednictwem parametru UseNetworkIsolation.

Właściwości parametrów

Typ:Uri
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-UseNetworkIsolation

W przypadku ustawienia zostanie utworzony link prywatny dla konta magazynu i/lub serwera SQL

Właściwości parametrów

Typ:Boolean
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

Wyjść

AzureSqlDatabaseImportExportBaseModel

Notatki

  • Słowa kluczowe: azure, azurerm, arm, resource, management, manager, sql, database, mssql