New-AzureRmSqlDatabaseDataMaskingRule
Erstellt eine Datenformatierungsregel für eine Datenbank.
Warnung
Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.
Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
New-AzureRmSqlDatabaseDataMaskingRule
-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-AzureRmSqlDatabaseDataMaskingRule erstellt eine Datenformatierungsregel für eine Azure SQL-Datenbank. Verwenden Sie zum Verwenden des Cmdlets die Parameter "ResourceGroupName", "ServerName", "DatabaseName" und "RuleId", 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
PS C:\>New-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -RuleId "Rule01" -SchemaName "Schema01" -TableName "Table01" -ColumnName "Column01" -MaskingFunction "Number" -NumberFrom 5 -NumberTo 14Mit 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. Die Regel heißt Regel01.
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: | 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: | 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 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 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 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
Nullable<T>[[System.UInt32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[System.Double, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]