New-AzSqlServer

模組:: Az.Sql Module

建立 SQL 資料庫伺服器。

語法

Default (預設值)

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>]
    [-EnableSoftDelete <Boolean>]
    [-SoftDeleteRetentionDays <Int32>]
    [-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：使用外部（Microsoft Entra ID）系統管理員、僅限 Microsoft Entra 驗證且沒有 SqlAdministratorCredentials 建立新的 Azure SQL 資料庫伺服器

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

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

範例 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 資料庫伺服器。

範例 4：建立新的 Azure SQL 資料庫伺服器，並啟用虛刪除保留，並預設保留天數

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

ResourceGroupName             : ResourceGroup01
ServerName                    : server01
Location                      : centralus
SqlAdministratorLogin         : ramtest
SqlAdministratorPassword      :
ServerVersion                 : 12.0
Tags                          :
Identity                      :
FullyQualifiedDomainName      : server01.database.windows.net
MinimalTlsVersion             : 1.2
PublicNetworkAccess           : Enabled
RestrictOutboundNetworkAccess : Disabled
Administrators                :
PrimaryUserAssignedIdentityId :
KeyId                         :
FederatedClientId             :
SoftDeleteRetentionDays       : 7

此命令會建立已啟用虛刪除保留的第 12 版 Azure SQL 資料庫伺服器（預設為 7 天）。

範例 5：建立新的 Azure SQL 資料庫伺服器，並啟用虛刪除保留，保留天數為 30 天

New-AzSqlServer -ResourceGroupName "ResourceGroup01" -Location "Central US" -ServerName "server01" -ServerVersion "12.0" -SqlAdministratorCredentials (Get-Credential) -EnableSoftDelete $true -SoftDeleteRetentionDays 30

ResourceGroupName             : ResourceGroup01
ServerName                    : server01
Location                      : centralus
SqlAdministratorLogin         : ramtest
SqlAdministratorPassword      :
ServerVersion                 : 12.0
Tags                          :
Identity                      :
FullyQualifiedDomainName      : server01.database.windows.net
MinimalTlsVersion             : 1.2
PublicNetworkAccess           : Enabled
RestrictOutboundNetworkAccess : Disabled
Administrators                :
PrimaryUserAssignedIdentityId :
KeyId                         :
FederatedClientId             :
SoftDeleteRetentionDays       : 30

此命令會建立虛刪除保留設定為 30 天的第 12 版 Azure SQL 資料庫伺服器。

參數

-AsJob

在背景執行 Cmdlet

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AssignIdentity

為此伺服器產生並指派 Microsoft Entra 身分識別，以與金鑰管理服務搭配使用（例如 Azure KeyVault）。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableActiveDirectoryOnlyAuthentication

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableSoftDelete

指定是否為伺服器啟用虛刪除保留。

參數屬性

類型:	Boolean
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExternalAdminName

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExternalAdminSID

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

參數屬性

類型:	Nullable<T>[Guid]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FederatedClientId

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

參數屬性

類型:	Nullable<T>[Guid]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IdentityType

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-KeyId

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MinimalTlsVersion

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

參數屬性

類型:	String
預設值:	1.2
接受的值:	None, 1.0, 1.1, 1.2
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PrimaryUserAssignedIdentityId

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PublicNetworkAccess

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-RestrictOutboundNetworkAccess

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ServerName

指定新伺服器的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	名稱

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ServerVersion

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SoftDeleteRetentionDays

指定伺服器的虛刪除保留天數。此參數的可接受值為 0-35。指定 0 以停用 SoftDelete

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SqlAdministratorCredentials

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

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tags

雜湊表形式的鍵值對。例如：@{key0=“value0”;key1=$null;key2=“值2”}

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	標記

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UserAssignedIdentityId

使用者指派的身分清單。

參數屬性

類型:	List<T>[String]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為

New-AzSqlServer

語法

Default (預設值)

Description

範例

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

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

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

範例 4：建立新的 Azure SQL 資料庫伺服器，並啟用虛刪除保留，並預設保留天數

範例 5：建立新的 Azure SQL 資料庫伺服器，並啟用虛刪除保留，保留天數為 30 天

參數

-AsJob

參數屬性

參數集

-AssignIdentity

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-EnableActiveDirectoryOnlyAuthentication

參數屬性

參數集

-EnableSoftDelete

參數屬性

參數集

-ExternalAdminName

參數屬性

參數集

-ExternalAdminSID

參數屬性

參數集

-FederatedClientId

參數屬性

參數集

-IdentityType

參數屬性

參數集

-KeyId

參數屬性

參數集

-Location

參數屬性

參數集

-MinimalTlsVersion

參數屬性

參數集

-PrimaryUserAssignedIdentityId

參數屬性

參數集

-PublicNetworkAccess

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-RestrictOutboundNetworkAccess

參數屬性

參數集

-ServerName

參數屬性

參數集

-ServerVersion

參數屬性

參數集

-SoftDeleteRetentionDays

參數屬性

參數集

-SqlAdministratorCredentials

參數屬性

參數集

-Tags

參數屬性

參數集

-UserAssignedIdentityId

參數屬性

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