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-Datenbankservers.
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 (Standard 7 Tage)
Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -EnableSoftDelete $true
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 mit dem Namen Server01 mit einem Standardaufbewahrungszeitraum von 7 Tagen aktiviert. Verwenden Sie zum Anpassen der Aufbewahrungsdauer den Parameter SoftDeleteRetentionDays.
Beispiel 4: Deaktivieren der Aufbewahrung für vorläufiges Löschen für den Server
Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -EnableSoftDelete $false -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 mit dem Namen 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: vgl
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
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. Wenn Sie einen anderen Aufbewahrungszeitraum angeben möchten, verwenden Sie den Parameter SoftDeleteRetentionDays.
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
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 35. 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
