New-AzSqlServer

  • Başvuru
Modül:
Az.Sql

SQL Veritabanı sunucusu oluşturur.

Sözdizimi

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'i bir Azure SQL Veritabanı sunucusu oluşturur.

Örnekler

Örnek 1: Yeni bir Azure SQL Veritabanı sunucusu oluşturma

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                     :

Bu komut bir sürüm 12 Azure SQL Veritabanı sunucusu oluşturur.

Örnek 2: Dış (Microsoft Entra ID) Yöneticisi, Microsoft Entra-only Authentication ve SqlAdministratorCredentials olmadan yeni bir Azure SQL Veritabanı sunucusu oluşturma

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

Bu komut, dış yönetici özellikleri ve Microsoft Entra-only kimlik doğrulamasının etkinleştirildiği bir sürüm 12 Azure SQL Veritabanı sunucusu oluşturur.

Örnek 3: TDE CMK ile yeni bir Azure SQL Veritabanı sunucusu oluşturma

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

Bu komut, TDE CMK etkinleştirilmiş bir sürüm 12 Azure SQL Veritabanı sunucusu oluşturur.

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AssignIdentity

Azure KeyVault gibi anahtar yönetim hizmetleriyle kullanmak üzere bu sunucu için bir Microsoft Entra kimliği oluşturun ve atayın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EnableActiveDirectoryOnlyAuthentication

Sunucuda Yalnızca Active Directory Kimlik Doğrulamasını etkinleştirin.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ExternalAdminName

Sunucu için Microsoft Entra yöneticisi olan kullanıcının, grubun veya uygulamanın görünen adını belirtir. Bu görünen ad, geçerli abonelikle ilişkilendirilmiş active directory'de bulunmalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ExternalAdminSID

Microsoft Entra yöneticisi olan kullanıcının, grubun veya uygulamanın nesne kimliğini belirtir.

Tür:Nullable<T>[Guid]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FederatedClientId

Kiracılar Arası CMK kullanırken sunucunun Federasyon istemci kimliğini belirtir, Kiracılar Arası CMK kullanmayı amaçlamıyorsanız bu değeri ayarlamayın

Tür:Nullable<T>[Guid]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IdentityType

Sunucuya atanacak kimlik türü. Olası değerler SystemAsssigned, UserAssigned, 'SystemAssigned,UserAssigned' ve None değerleridir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeyId

Şifreleme için kullanılan Azure Key Vault URI'si.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Location

Bu cmdlet'in sunucuyu oluşturduğu veri merkezinin konumunu belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MinimalTlsVersion

Sql Server için zorunlu kılınacak en düşük TLS sürümü

Tür:String
Kabul edilen değerler:None, 1.0, 1.1, 1.2
Position:Named
Default value:1.2
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PrimaryUserAssignedIdentityId

Birincil Kullanıcı Tarafından Yönetilen Kimlik (UMI) kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PublicNetworkAccess

Sunucuya genel ağ erişimine izin verilip verilmeyeceğini belirtmek için etkin/devre dışı bayrağını alır. Devre dışı bırakıldığında, yalnızca Özel Bağlantı aracılığıyla yapılan bağlantılar bu sunucuya ulaşabilir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Bu cmdlet'in sunucuyu atadığı kaynak grubunun adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-RestrictOutboundNetworkAccess

Etkinleştirildiğinde, yalnızca giden güvenlik duvarı kuralları tarafından izin verilen giden bağlantılar başarılı olur.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerName

Yeni sunucunun adını belirtir.

Tür:String
Diğer adlar:Name
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerVersion

Yeni sunucunun sürümünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır: 2.0 ve 12.0. Sürüm 11 sunucusu oluşturmak için 2.0'ı veya sürüm 12 sunucusu oluşturmak için 12.0'ı belirtin.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SqlAdministratorCredentials

Yeni sunucu için SQL Veritabanı sunucu yöneticisi kimlik bilgilerini belirtir. PSCredential nesnesi almak için Get-Credential cmdlet'ini kullanın. Daha fazla bilgi için yazın Get-Help Get-Credential.

Tür:PSCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Tags

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}

Tür:Hashtable
Diğer adlar:Tag
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UserAssignedIdentityId

Kullanıcı tarafından atanan kimliklerin listesi.

Tür:List<T>[String]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Çıkışlar

AzureSqlServerModel