Set-AzSqlServer
Ändrar egenskaper för en SQL Database-server.
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>]
Beskrivning
Cmdleten Set-AzSqlServer ändrar egenskaperna för en Azure SQL Database-server.
Exempel
Exempel 1: Återställa administratörslösenordet
$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
Det här kommandot återställer administratörslösenordet på AzureSQL-servern med namnet server01.
Exempel 2: Ändrar egenskaper för en SQL Database-server. (autogenerated)
Set-AzSqlServer -AssignIdentity -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'
Exempel 3: Aktivera kvarhållning av mjuk borttagning för servern
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
Det här kommandot möjliggör kvarhållning av mjuk borttagning på Azure SQL Server med namnet server01, med en kvarhållningsperiod på 7 dagar.
Exempel 4: Inaktivera kvarhållning av mjuk borttagning för servern
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
Det här kommandot inaktiverar kvarhållning av mjuk borttagning på Azure SQL Server med namnet server01.
Parametrar
-AssignIdentity
Generera och tilldela en Microsoft Entra-identitet för den här servern för användning med viktiga hanteringstjänster som Azure KeyVault.
Parameteregenskaper
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False Stöder jokrar: False DontShow: False Alias: jfr
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Parameteregenskaper
Typ: IAzureContextContainer
Standardvärde: None Stöder jokrar: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-EnableSoftDelete
Den här parametern är inaktuell och tas bort i maj 2026 (Az version 16.0.0 /Az.Sql version 7.0.0). Använd parametern SoftDeleteRetentionDays i stället.
Booleskt värde för om du vill aktivera mjuk borttagning för servern, så att servern kan återställas under standardvärdet 7 dagar efter att den har tagits bort. Om du vill aktivera mjuk borttagning använder du -SoftDeleteRetentionDays med värdet 1–7 dagar. Om du vill inaktivera mjuk borttagning använder du -SoftDeleteRetentionDays 0.
Parameteregenskaper
Typ: Boolean
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-FederatedClientId
Anger federerat klient-ID för servern när du använder CMK för flera klientorganisationer. Ange inte det här värdet om du inte vill använda CMK för flera klientorganisationer
Parameteregenskaper
Typ: Nullable<T> [ Guid ]
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Parameteregenskaper
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-IdentityType
Typ av identitet som ska tilldelas till servern. Möjliga värden är SystemAssigned, UserAssigned, "SystemAssigned,UserAssigned" och None.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-KeyId
Azure Key Vault-URI:n som används för kryptering.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-MinimalTlsVersion
Den lägsta TLS-version som ska tillämpas för Sql Server
Parameteregenskaper
Typ: String
Standardvärde: None Godkända värden: None, 1.0, 1.1, 1.2 Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-PrimaryUserAssignedIdentityId
Det primära användarhanterade identitets-ID:t (UMI).
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-PublicNetworkAccess
Tar en flagga, aktiverad/inaktiverad, för att ange om offentlig nätverksåtkomst till servern är tillåten eller inte.
När det är inaktiverat kan endast anslutningar som görs via privata länkar nå den här servern.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-ResourceGroupName
Anger namnet på den resursgrupp som servern har tilldelats.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter fastighetsnamn: True Värde från återstående argument: False
-RestrictOutboundNetworkAccess
När det är aktiverat lyckas endast utgående anslutningar som tillåts av de utgående brandväggsreglerna.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-ServerName
Anger namnet på servern som den här cmdleten ändrar.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False Alias: Namn
Parametermängder
(All)
Position: 1 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter fastighetsnamn: True Värde från återstående argument: False
-ServerVersion
Anger vilken version den här cmdleten ändrar servern till. De acceptabla värdena för den här parametern är: 2.0 och 12.0.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-SoftDeleteRetentionDays
Värde för kvarhållningsdagar för mjuk borttagning för servern så att servern kan återställas under det angivna antalet dagar efter att den har släppts. Endast giltiga värden är från 0–7. Om värdet är 0 inaktiveras kvarhållning av mjuk borttagning.
Parameteregenskaper
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-SqlAdministratorPassword
Anger ett nytt lösenord, som SecureString , för databasserveradministratören. Om du vill hämta en SecureString använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help ConvertTo-SecureString.
Parameteregenskaper
Typ: SecureString
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
Anger en ordlista med taggar som den här cmdleten associerar med servern. Nyckel/värde-par i form av en hashtabell som anges som taggar på servern. Exempel: @{key0="value0"; key1=$null; key2="value2"}
Typ: Hashtable
Standardvärde: None Stöder jokrar: False DontShow: False Alias: Tag
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-UserAssignedIdentityId
Listan över användartilldelade identiteter.
Parameteregenskaper
Typ: List<T> [ String ]
Standardvärde: None Stöder jokrar: False DontShow: False
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs.
Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False Stöder jokrar: False DontShow: False Alias: Wi
Parametermängder
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter fastighetsnamn: False Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utgångar
