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=password123' -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äng 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 '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äng 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 pscredential-objektet i variabeln $Credential. 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 '\\servername' -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 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 "domain\\username" -AsPlainText -Force
$Password = ConvertTo-SecureString "password" -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=password;" -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 acceptabla värdena för den här parametern är:

  • Windows
  • Grundläggande
  • Anonym.
Typ:String
accepterade värden:Windows, Basic, Anonymous
Position:6
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-Database

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

Typ:String
Position:8
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-NonCredentialValue

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

Typ:String
Position:5
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-Server

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

Typ:String
Position:7
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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 acceptabla värdena för den här parametern är:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Typ:String
accepterade värden:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters: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 av anslutningssträng. 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
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSDataFactory

String

Utdata

String

Kommentarer

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