New-AzSqlDatabaseDataMaskingRule

  • Referenz
Modul:
Az.Sql

Erstellt eine Datenformatierungsregel für eine Datenbank.

Syntax

New-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 New-AzSqlDatabaseDataMaskingRule erstellt eine Datenformatierungsregel für eine Azure SQL-Datenbank. Verwenden Sie zum Verwenden des Cmdlets die Parameter "ResourceGroupName", "ServerName" und "DatabaseName", um die Regel zu identifizieren. Geben Sie den TableName und ColumnName an, um das Ziel der Regel und den MaskingFunction-Parameter anzugeben, um zu definieren, wie die Daten maskiert werden. Wenn MaskingFunction den Wert „Number“ oder „Text“ aufweist, 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 der Parameter PassThru verwendet wird, 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: Erstellen einer Datenformatierungsregel für eine Zahlenspalte in einer Datenbank

New-AzSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"  -SchemaName "Schema01" -TableName "Table01" -ColumnName "Column01" -MaskingFunction "Number" -NumberFrom 5 -NumberTo 14

Mit diesem Befehl wird eine Datenformatierungsregel für die Spalte "Column01" in der Tabelle mit dem Namen "Table01" im Schema namens "Schema01" erstellt. Die Datenbank mit dem Namen "Database01" enthält alle diese Elemente. Die Regel ist eine Zahlenformatierungsregel, die eine Zufallszahl zwischen 5 und 14 als Maskenwert verwendet.

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:True
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 eine leere Zeichenfolge.

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