Freigeben über


Set-AzSqlDatabaseDataMaskingRule

Legt die Eigenschaften einer Datenformatierungsregel für eine Datenbank fest.

Syntax

Set-AzSqlDatabaseDataMaskingRule
   [-MaskingFunction <String>]
   [-PrefixSize <UInt32>]
   [-ReplacementString <String>]
   [-SuffixSize <UInt32>]
   [-NumberFrom <Double>]
   [-NumberTo <Double>]
   [-PassThru]
   -SchemaName <String>
   -TableName <String>
   -ColumnName <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzSqlDatabaseDataMaskingRule legt eine Datenformatierungsregel für eine Azure SQL-Datenbank fest. Geben Sie zum Verwenden des Cmdlets die Parameter "ResourceGroupName", "ServerName", "DatabaseName" und "RuleId" an, um die Regel zu identifizieren. Sie können einen der folgenden Parameter angeben, um ein neues Ziel für die Regel festzulegen: SchemaName, TableName oder ColumnName. Geben Sie den Parameter MaskingFunction an, um zu ändern, wie die Daten maskiert werden. Wenn Sie für MaskingFunction den Wert „Number“ oder „Text“ festlegen, können Sie die Parameter NumberFrom und NumberTo für die Zahlenmaskierung oder PrefixSize, ReplacementString und SuffixSize für die Textmaskierung angeben. Wenn der Befehl erfolgreich ausgeführt wurde und Sie den Parameter PassThru angeben, gibt das Cmdlet zusätzlich zu den Regelbezeichnern ein Objekt zurück, das die Eigenschaften der Datenmaskierungsregel beschreibt. Regelbezeichner umfassen, sind jedoch nicht beschränkt auf ResourceGroupName, ServerName, DatabaseName und RuleId. Dieses Cmdlet wird auch vom SQL Server Stretch Database-Dienst in Azure unterstützt.

Beispiele

Beispiel 1: Ändern des Bereichs einer Datenformatierungsregel in einer Datenbank

Set-AzSqlDatabaseDataMaskingRule -ResourceGroupName $params.rgname -ServerName $params.serverName  -DatabaseName $params.databaseName -SchemaName "dbo" -TableName  "table1" -ColumnName "column1" -MaskingFunction "Default"

Mit diesem Befehl wird eine Datenformatierungsregel mit der ID Rule17 geändert. Diese Regel wird in der Datenbank "Database01" auf Server01 ausgeführt. Dieser Befehl ändert die Grenzen für das Intervall, in dem eine Zufallszahl als maskierten Wert generiert wird. Der neue Bereich liegt zwischen 23 und 42.

Beispiel 2

Legt die Eigenschaften einer Datenformatierungsregel für eine Datenbank fest. (automatisch generiert)

Set-AzSqlDatabaseDataMaskingRule -ColumnName 'column1' -DatabaseName $params.databaseName -MaskingFunction NoMasking -NumberFrom 5 -NumberTo 14 -PrefixSize <UInt32> -ReplacementString <String> -ResourceGroupName $params.rgname -SchemaName 'dbo' -ServerName $params.serverName -SuffixSize <UInt32> -TableName 'table1'

Parameter

-ColumnName

Gibt den Namen der Spalte an, die von der Maskierungsregel bestimmt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatabaseName

Gibt den Namen der Datenbank an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaskingFunction

Gibt die Maskierungsfunktion an, die von der Regel verwendet wird. Zulässige Werte für diesen Parameter:

  • Standard
  • NoMasking
  • Text
  • Zahl
  • SocialSecurityNumber
  • CreditCardNumber
  • E-Mail Der Standardwert ist "Standard".
Typ:String
Zulässige Werte:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NumberFrom

Gibt die untere Grenze des Intervalls an, aus dem ein zufälliger Wert ausgewählt ist. Geben Sie diesen Parameter nur an, wenn Sie einen Wert von Number für den Parameter MaskingFunction angeben. Der Standardwert ist 0.

Typ:Nullable<T>[Double]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NumberTo

Gibt die obere Grenze des Intervalls an, aus dem ein zufälliger Wert ausgewählt wird. Geben Sie diesen Parameter nur an, wenn Sie einen Wert von Number für den Parameter MaskingFunction angeben. Der Standardwert ist 0.

Typ:Nullable<T>[Double]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrefixSize

Gibt die Anzahl der Zeichen am Anfang des Texts an, die nicht maskiert sind. Geben Sie diesen Parameter nur an, wenn Sie einen Textwert für den Parameter MaskingFunction angeben. Der Standardwert ist 0.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ReplacementString

Gibt die Anzahl der Zeichen am Ende des Texts an, die nicht maskiert sind. Geben Sie diesen Parameter nur an, wenn Sie einen Textwert für den Parameter MaskingFunction angeben. Der Standardwert ist 0.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, der die Datenbank zugewiesen ist.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SchemaName

Gibt den Namen eines Schemas an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServerName

Gibt den Namen des Servers an, auf dem die Datenbank gehostet wird.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SuffixSize

Gibt die Anzahl der Zeichen am Ende des Texts an, die nicht maskiert sind. Geben Sie diesen Parameter nur an, wenn Sie einen Textwert für den Parameter MaskingFunction angeben. Der Standardwert ist 0.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TableName

Gibt den Namen der Datenbanktabelle an, die die maskierte Spalte enthält.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Nullable<T>[[System.UInt32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Double, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Ausgaben

DatabaseDataMaskingRuleModel