Sdílet prostřednictvím

New-AzDataFactoryEncryptValue

  • Reference
Modul:
Az.DataFactory

Šifruje citlivá data.

Syntaxe

New-AzDataFactoryEncryptValue
   [-DataFactoryName] <String>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDataFactoryEncryptValue
   [-DataFactory] <PSDataFactory>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Rutina New-AzDataFactoryEncryptValue šifruje citlivá data, jako je heslo nebo připojovací řetězec Microsoft SQL Serveru, a vrátí zašifrovanou hodnotu.

Příklady

Příklad 1: Šifrování připojovacího řetězce jiného typu než ODBC

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;user id =user123;password=******' -AsPlainText -Force 
New-AzDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

První příkaz pomocí rutiny ConvertTo-SecureString převede zadaný připojovací řetězec na objekt SecureString a pak tento objekt uloží do proměnné $Value. Další informace potřebujete zadáním Get-Help ConvertTo-SecureString. Povolené hodnoty: PŘIPOJOVACÍ řetězec SQL Serveru nebo Oracle. Druhý příkaz vytvoří zašifrovanou hodnotu objektu uloženého v $Value pro zadanou datovou továrnu, bránu, skupinu prostředků a propojený typ služby.

Příklad 2: Zašifrujte připojovací řetězec jiného typu než ODBC, který používá ověřování systému Windows.

$Value = ConvertTo-SecureString -String 'Data Source=ContosoServer;Initial Catalog=catalog;Integrated Security=True' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesSqlLinkedService

První příkaz používá ConvertTo-SecureString k převodu zadaného připojovacího řetězce na objekt zabezpečeného řetězce a pak tento objekt uloží do proměnné $Value. Druhý příkaz používá rutinu Get-Credential ke shromáždění ověřování systému Windows (uživatelské jméno a heslo) a pak uloží tento objekt PSCredential v proměnné $Credential. Další informace potřebujete zadáním Get-Help Get-Credential. Třetí příkaz vytvoří zašifrovanou hodnotu objektu uloženého v $Value a $Credential pro zadanou datovou továrnu, bránu, skupinu prostředků a typ propojené služby.

Příklad 3: Šifrování názvu serveru a přihlašovacích údajů pro propojenou službu systému souborů

$Value = ConvertTo-SecureString "******" -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesFileSystemLinkedService

První příkaz používá ConvertTo-SecureString k převodu zadaného řetězce na zabezpečený řetězec a pak tento objekt uloží do proměnné $Value. Druhý příkaz používá Get-Credential ke shromáždění ověřování systému Windows (uživatelské jméno a heslo) a pak uloží tento objekt PSCredential v proměnné $Credential. Třetí příkaz vytvoří zašifrovanou hodnotu objektu uloženého v $Value a $Credential pro zadanou datovou továrnu, bránu, skupinu prostředků a typ propojené služby.

Příklad 4: Šifrování přihlašovacích údajů pro propojenou službu HDFS

$UserName = ConvertTo-SecureString "******" -AsPlainText -Force
$Password = ConvertTo-SecureString "******" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ($UserName, $Password)
New-AzDataFactoryEncryptValue -DataFactoryName "MyDataFactory" -ResourceGroupName "MyResourceGroup" -GatewayName "MyDataManagementGateway" -Type HdfsLinkedService -AuthenticationType Windows -Credential $Credential -NonCredentialValue "http://server01.com:50070/webhdfs/v1/user/username"

ConvertTo-SecureString příkaz převede zadaný řetězec na zabezpečený řetězec. Příkaz New-Object vytvoří objekt PSCredential pomocí zabezpečených řetězců uživatelského jména a hesla. Místo toho můžete použít příkaz Get-Credential ke shromažďování ověřování systému Windows (uživatelské jméno a heslo) a pak vrácený objekt PSCredential uložit do proměnné $credential, jak je znázorněno v předchozích příkladech. Příkaz New-AzDataFactoryEncryptValue vytvoří zašifrovanou hodnotu objektu uloženého v $Credential pro zadanou datovou továrnu, bránu, skupinu prostředků a typ propojené služby.

Příklad 5: Šifrování přihlašovacích údajů pro propojenou službu ODBC

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=******;" -AsPlainText -Force
New-AzDataFactoryEncryptValue -ResourceGroupName $RGName -DataFactoryName $DFName -GatewayName $Gateway -Type OnPremisesOdbcLinkedService -AuthenticationType Basic -NonCredentialValue "Driver={SQL Server};Server=server01.database.contoso.net; Database=HDISScenarioTest;" -Value $content

ConvertTo-SecureString příkaz převede zadaný řetězec na zabezpečený řetězec. Příkaz New-AzDataFactoryEncryptValue vytvoří zašifrovanou hodnotu objektu uloženého v $Value pro zadanou datovou továrnu, bránu, skupinu prostředků a typ propojené služby.

Parametry

-AuthenticationType

Určuje typ ověřování, který se má použít pro připojení ke zdroji dat. Přijatelné hodnoty pro tento parametr jsou:

  • Windows
  • Základní
  • Anonymní.
Typ:String
Přípustné hodnoty:Windows, Basic, Anonymous
Position:6
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje přihlašovací údaje pro ověřování systému Windows (uživatelské jméno a heslo), které se mají použít. Tato rutina zašifruje zde zadaná data přihlašovacích údajů.

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

-Database

Určuje název databáze propojené služby.

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

-DataFactory

Určuje objekt PSDataFactory. Tato rutina šifruje data pro objekt pro vytváření dat, který tento parametr určuje.

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

-DataFactoryName

Určuje název datové továrny. Tato rutina šifruje data pro objekt pro vytváření dat, který tento parametr určuje.

Typ:String
Position:1
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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GatewayName

Určuje název brány. Tato rutina šifruje data pro bránu, kterou tento parametr určuje.

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

-NonCredentialValue

Určuje část připojení ODBC (Open Database Connectivity) bez přihlašovacích údajů. Tento parametr platí pouze pro propojenou službu ODBC.

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

-ResourceGroupName

Určuje název skupiny prostředků Azure. Tato rutina šifruje data pro skupinu, kterou tento parametr určuje.

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

-Server

Určuje název serveru propojené služby.

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

-Type

Určuje typ propojené služby. Tato rutina šifruje data pro typ propojené služby, kterou tento parametr určuje. Přijatelné hodnoty pro tento parametr jsou:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Typ:String
Přípustné hodnoty:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Value

Určuje hodnotu, která se má šifrovat. Pro místní propojenou službu SQL Serveru a místní propojenou službu Oracle použijte připojovací řetězec. Pro místní propojenou službu ODBC použijte část připojovacího řetězce s přihlašovacími údaji. Pro místní propojenou službu systému souborů, pokud je systém souborů místní pro počítač brány, použijte místní nebo localhost a pokud je systém souborů na serveru, který se liší od počítače brány, použijte \\název_serveru.

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

Vstupy

PSDataFactory

String

Výstupy

String

Poznámky

  • Klíčová slova: azure, azurerm, arm, resource, management, manager, data, factory