Set-AzSqlServer
Módosítja az SQL Database-kiszolgáló tulajdonságait.
Szintaxis
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>]
Leírás
A Set-AzSqlServer parancsmag módosítja az 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 neve server01 rendszeren, 7 napos megőrzési időtartammal.
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 a server01 nevű Azure SQL Serveren.
Paraméterek
-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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False Aliasok: Cf
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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.
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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: False
-KeyId
A titkosításhoz használt Azure Key Vault URI.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: 0 Kötelező: True Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: True Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False Aliasok: Név
Paraméterhalmazok
(All)
Pozíció: 1 Kötelező: True Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: True Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: False
-SoftDeleteRetentionDays
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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: False
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"}
Típus: Hashtable
Alapértelmezett érték: None Támogató vadkártyák: False Don't Show: False Aliasok: Tag
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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ámogató vadkártyák: False Don't Show: False Aliasok: Wi
Paraméterhalmazok
(All)
Pozíció: Named Kötelező: False Érték a csővezetékből: False Érték a csővezetékből az ingatlan név szerint: False Érték a maradék argumentumokból: 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
