Dela via

New-AzDataFactoryEncryptValue

  • Referens
Modul:
Az.DataFactory

Krypterar känsliga data.

Syntax

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

Cmdleten New-AzDataFactoryEncryptValue krypterar känsliga data, till exempel ett lösenord eller en Microsoft SQL Server-anslutningssträng, och returnerar ett krypterat värde.

Exempel

Exempel 1: Kryptera en icke-ODBC-anslutningssträng

$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

Det första kommandot använder cmdleten ConvertTo-SecureString för att konvertera den angivna anslutningssträngen till ett SecureString--objekt och lagrar sedan objektet i variabeln $Value. Om du vill ha mer information skriver du Get-Help ConvertTo-SecureString. Tillåtna värden: SQL Server eller Oracle-anslutningssträng. Det andra kommandot skapar ett krypterat värde för objektet som lagras i $Value för den angivna datafabriken, gatewayen, resursgruppen och den länkade tjänsttypen.

Exempel 2: Kryptera en icke-ODBC-anslutningssträng som använder Windows-autentisering.

$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

Det första kommandot använder ConvertTo-SecureString för att konvertera den angivna anslutningssträngen till ett säkert strängobjekt och lagrar sedan objektet i variabeln $Value. Det andra kommandot använder cmdleten Get-Credential för att samla in Windows-autentiseringen (användarnamn och lösenord) och lagrar sedan det PSCredential--objektet i $Credential-variabeln. Om du vill ha mer information skriver du Get-Help Get-Credential. Det tredje kommandot skapar ett krypterat värde för objektet som lagras i $Value och $Credential för den angivna datafabriken, gatewayen, resursgruppen och den länkade tjänsttypen.

Exempel 3: Kryptera servernamn och autentiseringsuppgifter för länkad filsystemtjänst

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

Det första kommandot använder ConvertTo-SecureString för att konvertera den angivna strängen till en säker sträng och lagrar sedan objektet i variabeln $Value. Det andra kommandot använder Get-Credential- för att samla in Windows-autentiseringen (användarnamn och lösenord) och lagrar sedan det PSCredential--objektet i variabeln $Credential. Det tredje kommandot skapar ett krypterat värde för objektet som lagras i $Value och $Credential för den angivna datafabriken, gatewayen, resursgruppen och den länkade tjänsttypen.

Exempel 4: Kryptera autentiseringsuppgifter för länkad HDFS-tjänst

$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"

Kommandot ConvertTo-SecureString konverterar den angivna strängen till en säker sträng. Kommandot New-Object skapar ett PSCredential-objekt med hjälp av de säkra användarnamns- och lösenordssträngarna. I stället kan du använda kommandot Get-Credential för att samla in Windows-autentisering (användarnamn och lösenord) och sedan lagra det returnerade PSCredential--objektet i variabeln $credential enligt föregående exempel. Kommandot New-AzDataFactoryEncryptValue skapar ett krypterat värde för objektet som lagras i $Credential för den angivna datafabriken, gatewayen, resursgruppen och den länkade tjänsttypen.

Exempel 5: Kryptera autentiseringsuppgifter för ODBC-länkad tjänst

$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

Kommandot ConvertTo-SecureString konverterar den angivna strängen till en säker sträng. Kommandot New-AzDataFactoryEncryptValue skapar ett krypterat värde för objektet som lagras i $Value för den angivna datafabriken, gatewayen, resursgruppen och den länkade tjänsttypen.

Parametrar

-AuthenticationType

Anger vilken typ av autentisering som ska användas för att ansluta till datakällan. De godtagbara värdena för den här parametern är:

  • Windows
  • Grundläggande
  • Anonym.
Typ:String
Godkända värden:Windows, Basic, Anonymous
Position:6
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger de Windows-autentiseringsuppgifter (användarnamn och lösenord) som ska användas. Den här cmdleten krypterar de autentiseringsuppgifter som du anger här.

Typ:PSCredential
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Database

Anger databasnamnet för den länkade tjänsten.

Typ:String
Position:8
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DataFactory

Anger ett PSDataFactory- objekt. Den här cmdleten krypterar data för datafabriken som den här parametern anger.

Typ:PSDataFactory
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DataFactoryName

Anger namnet på en datafabrik. Den här cmdleten krypterar data för datafabriken som den här parametern anger.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GatewayName

Anger namnet på gatewayen. Den här cmdleten krypterar data för den gateway som den här parametern anger.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NonCredentialValue

Anger den icke-autentiseringsmässiga delen av ODBC-anslutningssträngen (Open Database Connectivity). Den här parametern gäller endast för den ODBC-länkade tjänsten.

Typ:String
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på en Azure-resursgrupp. Den här cmdleten krypterar data för den grupp som den här parametern anger.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Server

Anger servernamnet för den länkade tjänsten.

Typ:String
Position:7
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Type

Anger den länkade tjänsttypen. Den här cmdleten krypterar data för den länkade tjänsttyp som den här parametern anger. De godtagbara värdena för den här parametern är:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Typ:String
Godkända värden:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Value

Anger värdet som ska krypteras. För en lokal SQL Server-länkad tjänst och en lokal Oracle-länkad tjänst använder du en anslutningssträng. För en lokal ODBC-länkad tjänst använder du autentiseringsdelen i anslutningssträngen. För den lokala filsystemlänkade tjänsten använder du Lokalt eller localhost om filsystemet är lokalt för gatewaydatorn, och om filsystemet finns på en annan server än gatewaydatorn använder du \\servername.

Typ:SecureString
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSDataFactory

String

Utdata

String

Kommentarer

  • Nyckelord: azure, azurerm, arm, resource, management, manager, data, factories