New-AzSqlServer
Létrehoz egy SQL Database-kiszolgálót.
Syntax
Default (Alapértelmezett)
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
A New-AzSqlServer parancsmag létrehoz egy Azure SQL Database-kiszolgálót.
Példák
1. példa: Új Azure SQL Database-kiszolgáló létrehozása
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 :
Ez a parancs létrehoz egy 12-es verziójú Azure SQL Database-kiszolgálót.
2. példa: Új Azure SQL Database-kiszolgáló létrehozása külső (Microsoft Entra ID) rendszergazdával, csak Microsoft Entra-hitelesítéssel és SqlAdministrator-hitelesítő adatok nélkül
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
Ez a parancs létrehoz egy 12-es verziójú Azure SQL Database-kiszolgálót, amely külső rendszergazdai tulajdonságokkal rendelkezik, és engedélyezve van a Microsoft Entra-hitelesítés.
3. példa: Új Azure SQL Database-kiszolgáló létrehozása a TDE CMK használatával
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
Ez a parancs létrehoz egy 12-es verziójú Azure SQL Database-kiszolgálót, amelyen engedélyezve van a TDE CMK.
4. példa: Új Azure SQL Database-kiszolgáló létrehozása az alapértelmezett megőrzési napoknál engedélyezett helyreállítható törlési megőrzéssel
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
Ez a parancs létrehoz egy 12-es verziójú Azure SQL Database-kiszolgálót, amelyen engedélyezve van a helyreállítható törlés megőrzés (alapértelmezett 7 nap).
5. példa: Új Azure SQL Database-kiszolgáló létrehozása 30 megőrzési nappal engedélyezett helyreállítható törlési megőrzéssel
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
Ez a parancs létrehoz egy 12-es verziójú Azure SQL Database-kiszolgálót, amely 30 napos helyreállítható törlési megőrzési időtartammal rendelkezik.
Paraméterek
-AsJob
Parancsmag futtatása a háttérben
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-AssignIdentity
Microsoft Entra-identitás létrehozása és hozzárendelése ehhez a kiszolgálóhoz olyan kulcskezelési szolgáltatásokhoz, mint az Azure KeyVault.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: False Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Cf
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-EnableActiveDirectoryOnlyAuthentication
Csak Active Directory-hitelesítés engedélyezése a kiszolgálón.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-EnableSoftDelete
Megadja, hogy engedélyezve van-e a helyreállítható törlés megőrzés a kiszolgálón.
Paramétertulajdonságok
Típus: Boolean
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ExternalAdminName
Megadja annak a felhasználónak, csoportnak vagy alkalmazásnak a megjelenítendő nevét, amely a kiszolgáló Microsoft Entra-rendszergazdája. Ennek a megjelenítendő névnek az aktuális előfizetéshez társított Active Directoryban kell lennie.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ExternalAdminSID
Megadja annak a felhasználónak, csoportnak vagy alkalmazásnak az objektumazonosítóját, amely a Microsoft Entra rendszergazdája.
Paramétertulajdonságok
Típus: Nullable<T> [ Guid ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-FederatedClientId
Megadja a kiszolgáló összevont ügyfél-azonosítóját bérlőközi CMK használatakor. Ne állítsa be ezt az értéket, ha nem kívánja használni a bérlők közötti CMK-t
Paramétertulajdonságok
Típus: Nullable<T> [ Guid ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-IdentityType
A kiszolgálóhoz rendelendő identitás típusa. Lehetséges értékek: SystemAssigned, UserAssigned, "SystemAssigned,UserAssigned" és None.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-KeyId
A titkosításhoz használt Azure Key Vault URI.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Location
Megadja annak az adatközpontnak a helyét, ahol ez a parancsmag létrehozza a kiszolgálót.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-MinimalTlsVersion
Az SQL Server minimális TLS-verziója
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: 1.2 Elfogadott értékek: None, 1.0, 1.1, 1.2 Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-PrimaryUserAssignedIdentityId
Az elsődleges felhasználó által felügyelt identitás (UMI) azonosítója.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-PublicNetworkAccess
Engedélyezve vagy letiltva egy jelzőt használ annak megadásához, hogy engedélyezett-e a nyilvános hálózati hozzáférés a kiszolgálóhoz.
Ha le van tiltva, csak a privát kapcsolatokon keresztül létrehozott kapcsolatok érhetik el ezt a kiszolgálót.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ResourceGroupName
Annak az erőforráscsoportnak a nevét adja meg, amelyhez a parancsmag hozzárendeli a kiszolgálót.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: 0 Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-RestrictOutboundNetworkAccess
Ha engedélyezve van, csak a kimenő tűzfalszabályok által engedélyezett kimenő kapcsolatok lesznek sikeresek.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ServerName
Az új kiszolgáló nevét adja meg.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Név
Paraméterkészletek
(All)
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ServerVersion
Az új kiszolgáló verzióját adja meg. A paraméter elfogadható értékei a következők: 2.0 és 12.0.
11-es vagy 12.0-s verziójú kiszolgáló létrehozásához adja meg a 2.0-s verziót.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-SoftDeleteRetentionDays
Megadja a kiszolgáló helyreállítható törlési megőrzési napjait. A paraméter elfogadható értéke 0–35. A SoftDelete letiltásához adja meg a 0 értéket
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-SqlAdministratorCredentials
Megadja az SQL Database-kiszolgáló rendszergazdai hitelesítő adatait az új kiszolgálóhoz.
PSCredential objektum beszerzéséhez használja a Get-Credential parancsmagot. További információkért írja be a következőt Get-Help Get-Credential:
Paramétertulajdonságok
Típus: PSCredential
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"}
Típus: Hashtable
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Tag
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-UserAssignedIdentityId
A felhasználó által hozzárendelt identitások listája.
Paramétertulajdonságok
Típus: List<T> [ String ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna.
A parancsmag nem fut.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: False Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: Wi
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek
