Sdílet prostřednictvím


New-AzureRmSqlDatabaseDataMaskingRule

Vytvoří pravidlo maskování dat pro databázi.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Description

Rutina New-AzureRmSqlDatabaseDataMaskingRule vytvoří pravidlo maskování dat pro databázi Azure SQL. Pokud chcete tuto rutinu použít, identifikujte pravidlo pomocí parametrů ResourceGroupName, ServerName, DatabaseName a RuleId . Zadejte TableName a ColumnName k určení cíle pravidla a maskingFunction parametru definovat, jak se data maskují. Pokud má MaskingFunction hodnotu Number nebo Text, můžete pro maskování textu zadat parametry NumberFrom a NumberTo nebo PrefixSize, ReplacementString a SuffixSize . Pokud je příkaz úspěšný a použije se parametr PassThru , rutina vrátí objekt popisující vlastnosti pravidla maskování dat kromě identifikátorů pravidla. Identifikátory pravidel zahrnují, ale nejsou omezeny na ResourceGroupName, ServerName, DatabaseName a RuleID. Tuto rutinu podporuje také služba SQL Server Stretch Database v Azure.

Příklady

Příklad 1: Vytvoření pravidla maskování dat pro číselný sloupec v databázi

PS C:\>New-AzureRmSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -RuleId "Rule01" -SchemaName "Schema01" -TableName "Table01" -ColumnName "Column01" -MaskingFunction "Number" -NumberFrom 5 -NumberTo 14

Tento příkaz vytvoří pravidlo maskování dat pro sloupec s názvem Column01 v tabulce s názvem Table01 ve schématu s názvem Schema01. Databáze s názvem Database01 obsahuje všechny tyto položky. Pravidlo je pravidlo maskování čísel, které jako hodnotu masky používá náhodné číslo od 5 do 14. Pravidlo má název Rule01.

Parametry

-ColumnName

Určuje název sloupce, na který cílí pravidlo maskování.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DatabaseName

Určuje název databáze.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaskingFunction

Určuje maskovací funkci, kterou pravidlo používá. Tento parametr přijímá tyto hodnoty:

  • Výchozí
  • NoMasking
  • Text
  • Počet
  • SocialSecurityNumber
  • Číslo kreditní karty
  • Výchozí hodnota e-mailu je Výchozí.
Typ:String
Přípustné hodnoty:NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NumberFrom

Určuje dolní mez intervalu, ze kterého je vybrána náhodná hodnota. Tento parametr zadejte pouze v případě, že pro parametr MaskingFunction zadáte hodnotu Number. Výchozí hodnota je 0.

Typ:Nullable<T>[Double]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NumberTo

Určuje horní mez intervalu, ze kterého je vybrána náhodná hodnota. Tento parametr zadejte pouze v případě, že pro parametr MaskingFunction zadáte hodnotu Number. Výchozí hodnota je 0.

Typ:Nullable<T>[Double]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrefixSize

Určuje počet znaků na začátku textu, který není maskován. Tento parametr zadejte pouze v případě, že pro parametr MaskingFunction zadáte hodnotu Text. Výchozí hodnota je 0.

Typ:Nullable<T>[UInt32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ReplacementString

Určuje počet znaků na konci textu, které nejsou maskovány. Tento parametr zadejte pouze v případě, že pro parametr MaskingFunction zadáte hodnotu Text. Výchozí hodnota je prázdný řetězec.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, ke které je databáze přiřazena.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SchemaName

Určuje název schématu.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServerName

Určuje název serveru, který je hostitelem databáze.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SuffixSize

Určuje počet znaků na konci textu, který není maskován. Tento parametr zadejte pouze v případě, že pro parametr MaskingFunction zadáte hodnotu Text. Výchozí hodnota je 0.

Typ:Nullable<T>[UInt32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TableName

Určuje název databázové tabulky, která obsahuje maskovaný sloupec.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

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

Výstupy

DatabaseDataMaskingRuleModel