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
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]]