Set-AzSqlServer
Ändert die Eigenschaften eines SQL-Datenbankservers.
Syntax
Default (Standard)
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>]
Beschreibung
Das Cmdlet Set-AzSqlServer ändert die Eigenschaften eines Azure SQL-Datenbank Servers.
Beispiele
Beispiel 1: Zurücksetzen des Administratorkennworts
$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
Mit diesem Befehl wird das Administratorkennwort auf dem AzureSQL-Server namens "server01" zurückgesetzt.
Beispiel 2: Ändert die Eigenschaften eines SQL-Datenbankservers. (autogenerated)
Set-AzSqlServer -AssignIdentity -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'
Beispiel 3: Aktivieren der Aufbewahrung für vorläufiges Löschen für den Server
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
Mit diesem Befehl wird die Aufbewahrung für vorläufiges Löschen auf dem Azure SQL Server namens Server01 mit einem Aufbewahrungszeitraum von 7 Tagen ermöglicht.
Beispiel 4: Deaktivieren der Aufbewahrung für vorläufiges Löschen für den Server
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
Mit diesem Befehl wird die Aufbewahrung für vorläufiges Löschen auf dem Azure SQL Server benannten Server01 deaktiviert.
Parameter
-AssignIdentity
Generieren und Zuweisen einer Microsoft Entra Identität für diesen Server für die Verwendung mit Schlüsselverwaltungsdiensten wie Azure KeyVault.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Cf
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-EnableSoftDelete
Dieser Parameter ist veraltet und wird im Mai 2026 entfernt (Az Version 16.0.0 / Az.Sql Version 7.0.0.0). Verwenden Sie stattdessen den Parameter SoftDeleteRetentionDays.
[Öffentliche Vorschau] Boolescher Wert, der angibt, ob soft-delete für den Server aktiviert werden soll, sodass der Server für einen Standardwert von 7 Tagen nach dem Ablegen wiederhergestellt werden kann. Verwenden Sie -SoftDeleteRetentionDays zum Aktivieren des vorläufigen Löschens den Wert 1 bis 7 Tage. Verwenden Sie -SoftDeleteRetentionDays 0zum Deaktivieren des vorläufigen Löschens .
Parametereigenschaften
Typ: Boolean
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-FederatedClientId
Gibt die Verbundclient-ID des Servers bei Verwendung von mandantenübergreifendem CMK an, legen Sie diesen Wert nicht fest, wenn Sie nicht beabsichtigen, mandantenübergreifende CMK zu verwenden.
Parametereigenschaften
Typ: Nullable<T> [ Guid ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Force
Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-IdentityType
Der Identitätstyp, der dem Server zugewiesen werden soll. Mögliche Werte sind "SystemAssigned", "UserAssigned", "UserAssigned", "None".
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-KeyId
Der Azure Key Vault URI, der für die Verschlüsselung verwendet wird.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-MinimalTlsVersion
Die minimale TLS-Version, die für Sql Server erzwungen werden soll
Parametereigenschaften
Typ: String
Standardwert: None Zulässige Werte: None, 1.0, 1.1, 1.2 Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-PrimaryUserAssignedIdentityId
Die primäre BENUTZERverwaltete Identitäts-ID(UMI).
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-PublicNetworkAccess
Verwendet ein Flag, aktiviert/deaktiviert, um anzugeben, ob der Zugriff auf das öffentliche Netzwerk auf den Server zulässig ist oder nicht.
Wenn diese Option deaktiviert ist, können nur Über private Links hergestellte Verbindungen diesen Server erreichen.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Gibt den Namen der Ressourcengruppe an, der der Server zugewiesen ist.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: 0 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-RestrictOutboundNetworkAccess
Wenn diese Option aktiviert ist, werden nur ausgehende Verbindungen, die von den ausgehenden Firewallregeln zulässig sind, erfolgreich ausgeführt.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ServerName
Gibt den Namen des Servers an, den dieses Cmdlet ändert.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Name
Parametersätze
(All)
Position: 1 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ServerVersion
Gibt die Version an, in die dieses Cmdlet den Server ändert. Die zulässigen Werte für diesen Parameter sind: 2,0 und 12,0.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-SoftDeleteRetentionDays
[Öffentliche Vorschau] Wert für Aufbewahrungstage für vorläufig gelöschte Elemente für den Server, sodass der Server für die angegebene Anzahl von Tagen nach dem Ablegen wiederhergestellt werden kann. Nur gültige Werte liegen zwischen 0 und 7. Bei Festlegung auf 0 ist die Aufbewahrung für vorläufiges Löschen deaktiviert.
Parametereigenschaften
Typ: Nullable<T> [ Int32 ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-SqlAdministratorPassword
Gibt ein neues Kennwort als SecureString für den Datenbankserveradministrator an. Verwenden Sie zum Abrufen eines SecureString-Cmdlets das cmdlet Get-Credential. Geben Sie weitere Informationen ein Get-Help ConvertTo-SecureString.
Parametereigenschaften
Typ: SecureString
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
Gibt ein Wörterbuch mit Tags an, die dieses Cmdlet dem Server zuordnet. Schlüsselwertpaare in Form einer Hashtabelle, die als Tags auf dem Server festgelegt ist. Beispiel: @{key0="value0"; key1=$null; key2="value2"}
Typ: Hashtable
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Tag
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-UserAssignedIdentityId
Die Liste der vom Benutzer zugewiesenen Identitäten.
Parametereigenschaften
Typ: List<T> [ String ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird.
Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: Wi
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben
