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