Udostępnij przez

Set-AzSqlServer

Moduł:
Az.Sql Module

Modyfikuje właściwości serwera usługi SQL Database.

Składnia

Default (Domyślne) 

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

Opis

Polecenie cmdlet Set-AzSqlServer modyfikuje właściwości serwera usługi Azure SQL Database.

Przykłady

Przykład 1. Resetowanie hasła administratora

$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

To polecenie resetuje hasło administratora na serwerze AzureSQL o nazwie server01.

Przykład 2. Modyfikuje właściwości serwera usługi SQL Database. (autogenerated)

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

Przykład 3. Włączanie przechowywania usuwania nietrwałego dla serwera

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

To polecenie umożliwia przechowywanie usuwania nietrwałego w programie Azure SQL Server o nazwie server01 z okresem przechowywania przez 7 dni.

Przykład 4. Wyłączanie przechowywania usuwania nietrwałego dla serwera

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

To polecenie wyłącza przechowywanie usuwania nietrwałego w programie Azure SQL Server o nazwie server01.

Parametry

-AssignIdentity

Generowanie i przypisywanie tożsamości entra firmy Microsoft dla tego serwera do użycia z usługami zarządzania kluczami, takimi jak Azure KeyVault.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-EnableSoftDelete

Ten parametr został przestarzały i zostanie usunięty w maju 2026 r. (Az w wersji 16.0.0 / Az.Sql w wersji 7.0.0). Zamiast tego użyj parametru SoftDeleteRetentionDays.

Wartość logiczna dla tego, czy włączyć usuwanie nietrwałe dla serwera, tak aby można było przywrócić serwer domyślnie przez 7 dni po upuszczaniu. Aby włączyć usuwanie nietrwałe, użyj wartości -SoftDeleteRetentionDays 1–7 dni. Aby wyłączyć usuwanie nietrwałe, użyj polecenia -SoftDeleteRetentionDays 0.

Właściwości parametrów

Typ:Boolean
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-FederatedClientId

Określa identyfikator klienta federacyjnego serwera podczas korzystania z klucza cmK między dzierżawami, nie ustawiaj tej wartości, jeśli nie chcesz używać klucza cmK między dzierżawami

Właściwości parametrów

Typ:

Nullable<T>[Guid]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-IdentityType

Typ tożsamości, która ma zostać przypisana do serwera. Możliwe wartości to SystemAssigned, UserAssigned, "SystemAssigned,UserAssigned" i None.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-KeyId

Identyfikator URI usługi Azure Key Vault używany do szyfrowania.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-MinimalTlsVersion

Minimalna wersja protokołu TLS wymuszana dla programu Sql Server

Właściwości parametrów

Typ:String
Wartość domyślna:None
Akceptowane wartości:None, 1.0, 1.1, 1.2
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PrimaryUserAssignedIdentityId

Podstawowy identyfikator tożsamości zarządzanej użytkownika (UMI).

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PublicNetworkAccess

Pobiera flagę, włączoną/wyłączoną, aby określić, czy dostęp do sieci publicznej do serwera jest dozwolony, czy nie. Po wyłączeniu tylko połączenia wykonywane za pośrednictwem łączy prywatnych mogą uzyskiwać dostęp do tego serwera.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

Określa nazwę grupy zasobów, do której przypisano serwer.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-RestrictOutboundNetworkAccess

Po włączeniu tylko połączenia wychodzące dozwolone przez reguły zapory ruchu wychodzącego powiedzie się.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ServerName

Określa nazwę serwera, który modyfikuje to polecenie cmdlet.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Name

Zbiory parametrów

(All)
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ServerVersion

Określa wersję, do której to polecenie cmdlet zmienia serwer. Dopuszczalne wartości tego parametru to: 2.0 i 12.0.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-SoftDeleteRetentionDays

Wartość dni przechowywania usuwania nietrwałego dla serwera, tak aby można było przywrócić serwer przez określoną liczbę dni po upuszczaniu. Tylko prawidłowe wartości pochodzą od 0 do 7. Jeśli ustawiono wartość 0, przechowywanie usuwania nietrwałego jest wyłączone.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-SqlAdministratorPassword

Określa nowe hasło jako ciąg SecureString dla administratora serwera bazy danych. Aby uzyskać metodę SecureString, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz Get-Help ConvertTo-SecureString.

Właściwości parametrów

Typ:SecureString
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Tags

Określa słownik tagów, które to polecenie cmdlet kojarzy z serwerem. Pary klucz-wartość w postaci tabeli skrótów ustawione jako tagi na serwerze. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Tag

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-UserAssignedIdentityId

Lista tożsamości przypisanych przez użytkownika.

Właściwości parametrów

Typ:

List<T>[String]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

Wyjść

AzureSqlServerModel