Set-AzSqlDatabaseDataMaskingRule

  • Referenz
Modul:
Az.Sql

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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Gibt den Namen der Datenbank an.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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".
Type:String
Accepted values:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SchemaName

Gibt den Namen eines Schemas an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TableName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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