Auf Englisch lesen

Freigeben über

New-AzSqlDatabaseDataMaskingRule

  • Referenz
Modul:
Az.Sql

Erstellt eine Datenformatierungsregel für eine Datenbank.

Syntax

PowerShell 
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 Datenmaskenregel für eine Azure SQL-Datenbank. Verwenden Sie zum Verwenden des Cmdlets die Parameter ResourceGroupName, ServerNameund DatabaseName Parameter, um die Regel zu identifizieren. Geben Sie die TableName- und ColumnName- an, um das Ziel der Regel und den parameter MaskingFunction 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 Zahlenformatierung oder das PrefixSize, ReplacementString-und SuffixSize- für die Textformatierung angeben. Wenn der Befehl erfolgreich ist und der PassThru-Parameter verwendet wird, gibt das Cmdlet zusätzlich zu den Regelbezeichnern ein Objekt zurück, das die Eigenschaften der Datenformatierungsregel beschreibt. Regelbezeichner umfassen, jedoch nicht beschränkt auf ResourceGroupName, ServerName, DatabaseNameund 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

PowerShell 
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.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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. Die zulässigen Werte für diesen Parameter sind:

  • Vorgabe
  • 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:True
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 den Wert "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 den Wert "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 generiert dieses Cmdlet keine Ausgabe.

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

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 passiert, 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

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