다음을 통해 공유

New-AzSqlServer

  • 참조
모듈:
Az.Sql

SQL Database 서버를 만듭니다.

구문

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 Database 서버를 만듭니다.

예제

예제 1: 새 Azure SQL Database 서버 만들기

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 Database 서버를 만듭니다.

예제 2: 외부(Microsoft Entra ID) 관리자, Microsoft Entra 전용 인증 및 SqlAdministratorCredentials가 없는 새 Azure SQL Database 서버 만들기

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 Database 서버를 만듭니다.

예제 3: TDE CMK를 사용하여 새 Azure SQL Database 서버 만들기

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 Database 서버를 만듭니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AssignIdentity

Azure KeyVault와 같은 키 관리 서비스에 사용할 이 서버에 대한 Microsoft Entra ID를 생성하고 할당합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EnableActiveDirectoryOnlyAuthentication

서버에서 Active Directory 전용 인증을 사용하도록 설정합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ExternalAdminName

서버의 Microsoft Entra 관리자인 사용자, 그룹 또는 애플리케이션의 표시 이름을 지정합니다. 이 표시 이름은 현재 구독과 연결된 Active Directory에 있어야 합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ExternalAdminSID

Microsoft Entra 관리자인 사용자, 그룹 또는 애플리케이션의 개체 ID를 지정합니다.

형식:Nullable<T>[Guid]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FederatedClientId

교차 테넌트 CMK를 사용할 때 서버의 페더레이션된 클라이언트 ID를 지정합니다. 테넌트 간 CMK를 사용하려는 의도가 없는 경우 이 값을 설정하지 마세요.

형식:Nullable<T>[Guid]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IdentityType

서버에 할당할 ID의 유형입니다. 가능한 값은 SystemAsssigned, UserAssigned, 'SystemAssigned, UserAssigned' 및 None입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-KeyId

암호화에 사용되는 Azure Key Vault URI입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Location

이 cmdlet이 서버를 만드는 데이터 센터의 위치를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MinimalTlsVersion

Sql Server에 적용할 최소 TLS 버전

형식:String
허용되는 값:None, 1.0, 1.1, 1.2
Position:Named
Default value:1.2
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PrimaryUserAssignedIdentityId

기본 UMI(사용자 관리 ID) ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PublicNetworkAccess

서버에 대한 공용 네트워크 액세스가 허용되는지 여부를 지정하기 위해 사용/사용 안 함 플래그를 사용합니다. 사용하지 않도록 설정하면 Private Links를 통한 연결만 이 서버에 연결할 수 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

이 cmdlet이 서버를 할당하는 리소스 그룹의 이름을 지정합니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RestrictOutboundNetworkAccess

사용하도록 설정하면 아웃바운드 방화벽 규칙에서 허용하는 아웃바운드 연결만 성공합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerName

새 서버의 이름을 지정합니다.

형식:String
별칭:Name
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerVersion

새 서버의 버전을 지정합니다. 이 매개 변수에 허용되는 값은 2.0 및 12.0입니다. 버전 11 서버를 만들려면 2.0을 지정하고, 버전 12 서버를 만들려면 12.0을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SqlAdministratorCredentials

새 서버에 대한 SQL Database 서버 관리자 자격 증명을 지정합니다. PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 다음을 입력합니다 Get-Help Get-Credential.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tags

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}

형식:Hashtable
별칭:Tag
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UserAssignedIdentityId

사용자 할당 ID 목록입니다.

형식:List<T>[String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

출력

AzureSqlServerModel