Delen via


Set-AzSqlServer

Wijzigt eigenschappen van een SQL Database-server.

Syntaxis

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>]
   [-Force]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-AzSqlServer wijzigt eigenschappen van een Azure SQL Database-server.

Voorbeelden

Voorbeeld 1: Het beheerderswachtwoord opnieuw instellen

$ServerPassword = "newpassword"
$SecureString = ConvertTo-SecureString $ServerPassword -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

Met deze opdracht wordt het beheerderswachtwoord opnieuw ingesteld op de AzureSQL-server met de naam server01.

Voorbeeld 2

Wijzigt eigenschappen van een SQL Database-server. (automatisch gegenereerd)

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

Parameters

-AssignIdentity

Genereer en wijs een Microsoft Entra-identiteit toe voor deze server voor gebruik met sleutelbeheerservices zoals Azure KeyVault.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FederatedClientId

Hiermee geeft u de federatieve client-id van de server bij het gebruik van CMK voor meerdere tenants. Stel deze waarde niet in als u geen cmk voor meerdere tenants wilt gebruiken

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdentityType

Het type identiteit dat moet worden toegewezen aan de server. Mogelijke waarden zijn SystemAsssigned, UserAssigned, SystemAssigned, UserAssigned en None.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KeyId

De Azure Key Vault-URI die wordt gebruikt voor versleuteling.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinimalTlsVersion

De minimale TLS-versie die moet worden afgedwongen voor Sql Server

Type:String
Geaccepteerde waarden:None, 1.0, 1.1, 1.2
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrimaryUserAssignedIdentityId

De primaire door de gebruiker beheerde identiteit(UMI) id.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicNetworkAccess

Hiermee wordt een vlag, ingeschakeld/uitgeschakeld, gebruikt om op te geven of openbare netwerktoegang tot de server is toegestaan of niet. Wanneer deze optie is uitgeschakeld, kunnen alleen verbindingen via privékoppelingen deze server bereiken.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waaraan de server is toegewezen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RestrictOutboundNetworkAccess

Wanneer deze optie is ingeschakeld, slagen alleen uitgaande verbindingen die zijn toegestaan door de uitgaande firewallregels.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerName

Hiermee geeft u de naam op van de server die door deze cmdlet wordt gewijzigd.

Type:String
Aliassen:Name
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServerVersion

Hiermee geeft u de versie op waarop deze cmdlet de server wijzigt. De acceptabele waarden voor deze parameter zijn: 2.0 en 12.0.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SqlAdministratorPassword

Hiermee geeft u een nieuw wachtwoord, als SecureString, op voor de beheerder van de databaseserver. Gebruik de cmdlet Get-Credential om een SecureString te verkrijgen. Typ voor meer informatie Get-Help ConvertTo-SecureString.

Type:SecureString
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tags

Hiermee geeft u een woordenlijst op met tags die deze cmdlet aan de server koppelt. Sleutel-waardeparen in de vorm van een hash-tabelset als tags op de server. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Aliassen:Tag
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserAssignedIdentityId

De lijst met door de gebruiker toegewezen identiteiten.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

AzureSqlServerModel