Sdílet prostřednictvím

New-AzSqlServer

  • Reference
Modul:
Az.Sql

Vytvoří server služby SQL Database.

Syntaxe

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

Rutina New-AzSqlServer vytvoří server Azure SQL Database.

Příklady

Příklad 1: Vytvoření nového serveru 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                     :

Tento příkaz vytvoří server Azure SQL Database verze 12.

Příklad 2: Vytvoření nového serveru Azure SQL Database s externím správcem (Microsoft Entra ID), ověřováním Microsoft Entra pouze a bez 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

Tento příkaz vytvoří server služby Azure SQL Database verze 12 s vlastnostmi externího správce a povoleným ověřováním pouze Microsoft Entra.

Příklad 3: Vytvoření nového serveru Azure SQL Database s využitím TDE CMK

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

Tento příkaz vytvoří server služby Azure SQL Database verze 12 s povoleným klíčem TDE CMK.

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AssignIdentity

Vygenerujte a přiřaďte identitu Microsoft Entra pro tento server pro použití se službami pro správu klíčů, jako je Azure KeyVault.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableActiveDirectoryOnlyAuthentication

Povolte na serveru pouze ověřování služby Active Directory.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ExternalAdminName

Určuje zobrazovaný název uživatele, skupiny nebo aplikace, což je správce Microsoft Entra pro server. Tento zobrazovaný název musí existovat ve službě Active Directory přidružené k aktuálnímu předplatnému.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ExternalAdminSID

Určuje ID objektu uživatele, skupiny nebo aplikace, což je správce Microsoft Entra.

Typ:Nullable<T>[Guid]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FederatedClientId

Určuje ID federovaného klienta serveru při použití klíče CMK mezi tenanty, nenastavujte tuto hodnotu, pokud nechcete používat klíč CMK mezi tenanty.

Typ:Nullable<T>[Guid]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdentityType

Typ identity, která se má přiřadit k serveru. Možné hodnoty jsou SystemAsssigned, UserAssigned, 'SystemAssigned,UserAssigned' a None.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyId

Identifikátor URI služby Azure Key Vault, který se používá k šifrování.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Určuje umístění datového centra, kde tato rutina vytvoří server.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MinimalTlsVersion

Minimální verze protokolu TLS, která se má vynutit pro Sql Server

Typ:String
Přípustné hodnoty:None, 1.0, 1.1, 1.2
Position:Named
Default value:1.2
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrimaryUserAssignedIdentityId

Primární ID spravované identity uživatele (UMI).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicNetworkAccess

Vezme příznak s povolenou nebo zakázanou a určuje, jestli je povolený nebo nepřístupný veřejný síťový přístup k serveru. Pokud je tato možnost zakázaná, můžou se k tomuto serveru dostat pouze připojení vytvořená prostřednictvím privátních propojení.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, ke které tato rutina přiřadí server.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RestrictOutboundNetworkAccess

Pokud je tato možnost povolená, budou úspěšná pouze odchozí připojení povolená pravidly brány firewall odchozích přenosů.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerName

Určuje název nového serveru.

Typ:String
Aliasy:Name
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerVersion

Určuje verzi nového serveru. Přijatelné hodnoty pro tento parametr jsou: 2.0 a 12.0. Zadáním verze 2.0 vytvořte server verze 11 nebo 12.0 pro vytvoření serveru verze 12.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SqlAdministratorCredentials

Určuje přihlašovací údaje správce serveru SLUŽBY SQL Database pro nový server. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tags

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tag
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserAssignedIdentityId

Seznam identit přiřazených uživatelem

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

AzureSqlServerModel