New-AzSqlDatabaseDataMaskingRule

Modul:

Az.Sql Module

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

Syntax

Default (Výchozí)

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

Description

Rutina New-AzSqlDatabaseDataMaskingRule vytvoří pravidlo maskování dat pro databázi Azure SQL. Pokud chcete tuto rutinu použít, identifikujte pravidlo pomocí parametrů ResourceGroupName, ServerName a DatabaseName. 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

New-AzSqlDatabaseDataMaskingRule -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"  -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.

Parametry

-ColumnName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DatabaseName

Určuje název databáze.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaskingFunction

Určuje maskovací funkci, kterou pravidlo používá. Přijatelné hodnoty pro tento parametr jsou:

• Výchozí
• NoMasking
• Text
• Number
• SocialSecurityNumber
• Číslo kreditní karty
• Výchozí hodnota e-mailu je Výchozí.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	NoMasking, Default, Text, Number, SocialSecurityNumber, CreditCardNumber, Email
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Nullable<T>[Double]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Nullable<T>[Double]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PassThru

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Nullable<T>[UInt32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SchemaName

Určuje název schématu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ServerName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Nullable<T>[UInt32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-TableName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Nullable<T>

Nullable<T>

Výstupy

DatabaseDataMaskingRuleModel

Související odkazy

• Get-AzSqlDatabaseDataMaskingRule
• Remove-AzSqlDatabaseDataMaskingRule
• Set-AzSqlDatabaseDataMaskingRule
• Dokumentace ke službě SQL Database