Set-AzSqlServer

Modul:

Az.Sql Module

Módosítja az SQL Database-kiszolgáló tulajdonságait.

Syntax

Default (Alapértelmezett)

Set-AzSqlServer
    [-ServerName] <String>
    [-SqlAdministratorPassword <SecureString>]
    [-Tags <Hashtable>]
    [-ServerVersion <String>]
    [-AssignIdentity]
    [-PublicNetworkAccess <String>]
    [-RestrictOutboundNetworkAccess <String>]
    [-MinimalTlsVersion <String>]
    [-PrimaryUserAssignedIdentityId <String>]
    [-KeyId <String>]
    [-FederatedClientId <Guid>]
    [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
    [-IdentityType <String>]
    [-EnableSoftDelete <Boolean>]
    [-SoftDeleteRetentionDays <Int32>]
    [-Force]
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

A Set-AzSqlServer parancsmag módosítja egy Azure SQL Database-kiszolgáló tulajdonságait.

Példák

1. példa: A rendszergazdai jelszó alaphelyzetbe állítása

$SecureString = ConvertTo-SecureString -String "****" -AsPlainText -Force
Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -SqlAdministratorPassword $secureString

ResourceGroupName        : ResourceGroup01
ServerName               : Server01
Location                 : Australia East
SqlAdministratorLogin    : adminLogin
SqlAdministratorPassword :
ServerVersion            : 12.0
Tags                     :
Identity                 :
FullyQualifiedDomainName : server01.database.windows.net

Ez a parancs alaphelyzetbe állítja a rendszergazdai jelszót a server01 nevű AzureSQL-kiszolgálón.

2. példa: Módosítja az SQL Database-kiszolgáló tulajdonságait. (autogenerated)

Set-AzSqlServer -AssignIdentity -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'

3. példa: Helyreállítható törlési megőrzés engedélyezése a kiszolgáló számára

Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -SoftDeleteRetentionDays 7

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
Location                      : centralus
SqlAdministratorLogin         : SqlAdminUser
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 lehetővé teszi a helyreállítható törlési megőrzést az Azure SQL Server nevű kiszolgálón01, 7 napos megőrzési idővel.

4. példa: A helyreállítható törlés megőrzésének letiltása a kiszolgálón

Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -SoftDeleteRetentionDays 0

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

Ez a parancs letiltja a helyreállítható törlési megőrzést az Azure SQL Server nevű kiszolgálón01.

Paraméterek

-AssignIdentity

Hozzon létre és rendeljen hozzá egy Microsoft Entra identitást ehhez a kiszolgálóhoz, amely olyan kulcskezelési szolgáltatásokkal használható, mint 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

-EnableSoftDelete

Ez a paraméter elavult, és 2026 májusában el lesz távolítva (Az 16.0.0/Az.Sql 7.0.0-s verzió). Használja helyette a SoftDeleteRetentionDays paramétert.

[Nyilvános előzetes verzió] Logikai érték arra vonatkozóan, hogy engedélyezi-e a helyreállítható törlést a kiszolgáló számára, hogy a kiszolgáló alapértelmezés szerint 7 nappal az elvetés után visszaállítható legyen. A helyreállítható törlés engedélyezéséhez használja -SoftDeleteRetentionDays 1-7 napos értékkel. A helyreállítható törlés letiltásához használja a következőt -SoftDeleteRetentionDays 0: .

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

-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

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

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

-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

-MinimalTlsVersion

Az SQL Server minimális TLS-verziója

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
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 kiszolgáló hozzá van rendelve.

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

Annak a kiszolgálónak a nevét adja meg, amelyet ez a parancsmag módosít.

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:	1
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

-ServerVersion

Azt a verziót adja meg, amelyre a parancsmag módosítja a kiszolgálót. A paraméter elfogadható értékei a következők: 2.0 és 12.0.

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

[Nyilvános előzetes verzió] A helyreállítható törlési megőrzési napok értéke a kiszolgáló számára, hogy a kiszolgáló a leengedés utáni megadott számú napra visszaállítható legyen. Csak az érvényes értékek 0 és 7 között vannak. Ha 0 értékre van állítva, a helyreállítható törlés megőrzési ideje le van tiltva.

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

-SqlAdministratorPassword

Új jelszót ad meg SecureStringként az adatbázis-kiszolgáló rendszergazdájának. SecureString beszerzéséhez használja a Get-Credential parancsmagot. További információkért írja be a következőt Get-Help ConvertTo-SecureString:

Paramétertulajdonságok

Típus:	SecureString
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

-Tags

A parancsmag által a kiszolgálóhoz társított címkék szótárát adja meg. Kulcs-érték párok kivonattábla formájában, címkékként a kiszolgálón. Például: @{key0="value0"; key1=$null; key2="value2"}

Paramétertulajdonságok

Típus:	Hashtable
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Címke

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

-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.

Bevitelek

String

Kimenetek

AzureSqlServerModel

Kapcsolódó hivatkozások

• Az SQL Database dokumentációja