New-AzSqlServer

參考

模組:: Az.Sql

建立 SQL 資料庫伺服器。

語法

New-AzSqlServer
   -ServerName <String>
   [-SqlAdministratorCredentials <PSCredential>]
   -Location <String>
   [-Tags <Hashtable>]
   [-ServerVersion <String>]
   [-AssignIdentity]
   [-PublicNetworkAccess <String>]
   [-RestrictOutboundNetworkAccess <String>]
   [-MinimalTlsVersion <String>]
   [-PrimaryUserAssignedIdentityId <String>]
   [-KeyId <String>]
   [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
   [-IdentityType <String>]
   [-AsJob]
   [-EnableActiveDirectoryOnlyAuthentication]
   [-ExternalAdminName <String>]
   [-ExternalAdminSID <Guid>]
   [-FederatedClientId <Guid>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzSqlServer Cmdlet 會建立 Azure SQL 資料庫伺服器。

範例

範例 1：建立新的 Azure SQL 資料庫伺服器

New-AzSqlServer -ResourceGroupName "ResourceGroup01" -Location "Central US" -ServerName "server01" -ServerVersion "12.0" -SqlAdministratorCredentials (Get-Credential)

ResourceGroupName        : resourcegroup01
ServerName               : server01
Location                 : Central US
SqlAdministratorLogin    : adminLogin
SqlAdministratorPassword :
ServerVersion            : 12.0
Tags                     :

此命令會建立第 12 版 Azure SQL 資料庫伺服器。

範例 2：使用 External （Microsoft Entra ID）系統管理員建立新的 Azure SQL 資料庫伺服器，Microsoft僅限 Entra 驗證且沒有 SqlAdministratorCredentials

New-AzSqlServer -ResourceGroupName "ResourceGroup01" -Location "Central US" -ServerName "server01" -ServerVersion "12.0" -ExternalAdminName DummyLogin -EnableActiveDirectoryOnlyAuthentication
ResourceGroupName        : resourcegroup01
ServerName               : server01
Location                 : Central US
SqlAdministratorLogin    : adminLogin
SqlAdministratorPassword :
ServerVersion            : 12.0
Tags                     :
Administrators           :

$val = Get-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "server01" -ExpandActiveDirectoryAdministrator
ResourceGroupName        : resourcegroup01
ServerName               : server01
Location                 : Central US
SqlAdministratorLogin    : randomLogin
SqlAdministratorPassword :
ServerVersion            : 12.0
Tags                     :
Administrators           : Microsoft.Azure.Management.Sql.Models.ServerExternalAdministrator

$val.Administrators
AdministratorType         : ActiveDirectory
PrincipalType             : Group
Login                     : DummyLogin
Sid                       : df7667b8-f9fd-4029-a0e3-b43c75ce9538
TenantId                  : 00001111-aaaa-2222-bbbb-3333cccc4444
AzureADOnlyAuthentication : True

此命令會建立第 12 版 Azure SQL 資料庫伺服器，並啟用外部系統管理員屬性並啟用Microsoft僅限 Entra 驗證。

範例 3：使用 TDE CMK 建立新的 Azure SQL 資料庫伺服器

New-AzSqlServer -ResourceGroupName "ResourceGroup01" -Location "East US" -ServerName "server01" -ServerVersion "12.0" -SqlAdministratorCredentials (Get-Credential) -AssignIdentity -IdentityType "UserAssigned" -PrimaryUserAssignedIdentityId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity01" -UserAssignedIdentityId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity01" -KeyId "https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901"

ResourceGroupName        : resourcegroup01
ServerName               : server01
Location                 : East US
SqlAdministratorLogin    : adminLogin
SqlAdministratorPassword :
ServerVersion            : 12.0
Tags                     :
Identity                 : Microsoft.Azure.Management.Sql.Models.ResourceIdentity
KeyId                    : https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901
PrimaryUserAssignedIdentityId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity01

此命令會建立已啟用 TDE CMK 的 12 版 Azure SQL 資料庫伺服器。

參數

-AsJob

在背景執行 Cmdlet

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AssignIdentity

產生並指派此伺服器的 Microsoft Entra 身分識別，以搭配 Azure KeyVault 等密鑰管理服務使用。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableActiveDirectoryOnlyAuthentication

在伺服器上啟用僅限 Active Directory 驗證。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExternalAdminName

指定使用者、群組或應用程式的顯示名稱，這是伺服器的Microsoft Entra 系統管理員。此顯示名稱必須存在於與目前訂用帳戶相關聯的 Active Directory 中。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExternalAdminSID

指定使用者、群組或應用程式的物件標識碼，這是Microsoft Entra 系統管理員。

類型:	Nullable<T>[Guid]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-FederatedClientId

使用跨租使用者 CMK 時指定伺服器的同盟用戶端識別碼，如果您不打算使用跨租使用者 CMK，請勿設定此值

類型:	Nullable<T>[Guid]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityType

要指派給伺服器的身分識別類型。可能的值為 SystemAsssigned、UserAssigned、'SystemAssigned、UserAssigned' 和 None。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyId

用於加密的 Azure 金鑰保存庫 URI。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

指定此 Cmdlet 建立伺服器之資料中心的位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MinimalTlsVersion

要針對 Sql Server 強制執行的最低 TLS 版本

類型:	String
接受的值:	None, 1.0, 1.1, 1.2
Position:	Named
預設值:	1.2
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrimaryUserAssignedIdentityId

主要使用者受控識別（UMI）識別碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicNetworkAccess

接受已啟用/停用的旗標，以指定是否允許對伺服器的公用網路存取。停用時，只有透過 Private Links 建立的連線才能連線到此伺服器。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

指定此 Cmdlet 指派伺服器的資源群組名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-RestrictOutboundNetworkAccess

啟用時，只有輸出防火牆規則允許的輸出聯機會成功。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServerName

指定新伺服器的名稱。

類型:	String
別名:	Name
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ServerVersion

指定新伺服器的版本。此參數可接受的值為：2.0 和 12.0。指定 2.0 來建立 11 版伺服器，或指定 12.0 來建立 12 版伺服器。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SqlAdministratorCredentials

指定新伺服器的 SQL 資料庫伺服器管理員認證。若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。如需詳細資訊，請輸入 Get-Help Get-Credential。

類型:	PSCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tags

哈希表形式的索引鍵/值組。例如：@{key0=“value0”;key1=$null;key2=“value2”}

類型:	Hashtable
別名:	Tag
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserAssignedIdentityId

使用者指派的身分識別清單。

類型:	List<T>[String]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

輸出

AzureSqlServerModel

共用方式為

New-AzSqlServer

語法

Description

範例

範例 1：建立新的 Azure SQL 資料庫伺服器

範例 2：使用 External （Microsoft Entra ID）系統管理員建立新的 Azure SQL 資料庫伺服器，Microsoft僅限 Entra 驗證且沒有 SqlAdministratorCredentials

範例 3：使用 TDE CMK 建立新的 Azure SQL 資料庫伺服器

參數

-AsJob

-AssignIdentity

-Confirm

-DefaultProfile

-EnableActiveDirectoryOnlyAuthentication

-ExternalAdminName

-ExternalAdminSID

-FederatedClientId

-IdentityType

-KeyId

-Location

-MinimalTlsVersion

-PrimaryUserAssignedIdentityId

-PublicNetworkAccess

-ResourceGroupName

-RestrictOutboundNetworkAccess

-ServerName

-ServerVersion

-SqlAdministratorCredentials

-Tags

-UserAssignedIdentityId

-WhatIf

輸入

輸出

其他資源

共用方式為

New-AzSqlServer

語法

Description

範例

範例 1：建立新的 Azure SQL 資料庫 伺服器

範例 2：使用 External （Microsoft Entra ID） 系統管理員建立新的 Azure SQL 資料庫 伺服器，Microsoft僅限 Entra 驗證且沒有 SqlAdministratorCredentials

範例 3：使用 TDE CMK 建立新的 Azure SQL 資料庫 伺服器

參數

-AsJob

-AssignIdentity

-Confirm

-DefaultProfile

-EnableActiveDirectoryOnlyAuthentication

-ExternalAdminName

-ExternalAdminSID

-FederatedClientId

-IdentityType

-KeyId

-Location

-MinimalTlsVersion

-PrimaryUserAssignedIdentityId

-PublicNetworkAccess

-ResourceGroupName

-RestrictOutboundNetworkAccess

-ServerName

-ServerVersion

-SqlAdministratorCredentials

-Tags

-UserAssignedIdentityId

-WhatIf

輸入

輸出

相關連結

其他資源

範例 1：建立新的 Azure SQL 資料庫伺服器

範例 2：使用 External （Microsoft Entra ID）系統管理員建立新的 Azure SQL 資料庫伺服器，Microsoft僅限 Entra 驗證且沒有 SqlAdministratorCredentials

範例 3：使用 TDE CMK 建立新的 Azure SQL 資料庫伺服器