New-AzDataFactoryEncryptValue

Referensi

Modul:: Az.DataFactory

Mengenkripsi data sensitif.

Sintaks

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

Deskripsi

Cmdlet New-AzDataFactoryEncryptValue mengenkripsi data sensitif, seperti kata sandi atau string koneksi Microsoft SQL Server, dan mengembalikan nilai terenkripsi.

Contoh

Contoh 1: Mengenkripsi string koneksi non-ODBC

$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

Perintah pertama menggunakan cmdlet ConvertTo-SecureString untuk mengonversi string koneksi yang ditentukan menjadi objek SecureString , lalu menyimpan objek tersebut dalam variabel $Value. Untuk informasi selengkapnya, ketik Get-Help ConvertTo-SecureString. Nilai yang diizinkan: SQL Server atau string koneksi Oracle. Perintah kedua membuat nilai terenkripsi untuk objek yang disimpan di $Value untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 2: Mengenkripsi string koneksi non-ODBC yang menggunakan autentikasi Windows.

$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

Perintah pertama menggunakan ConvertTo-SecureString untuk mengonversi string koneksi yang ditentukan menjadi objek string aman, lalu menyimpan objek tersebut dalam variabel $Value. Perintah kedua menggunakan cmdlet Get-Credential untuk mengumpulkan autentikasi windows (nama pengguna dan kata sandi), lalu menyimpan objek PSCredential tersebut dalam variabel $Credential. Untuk informasi selengkapnya, ketik Get-Help Get-Credential. Perintah ketiga membuat nilai terenkripsi untuk objek yang disimpan di $Value dan $Credential untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 3: Mengenkripsi nama server dan kredensial untuk layanan tertaut sistem File

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

Perintah pertama menggunakan ConvertTo-SecureString untuk mengonversi string yang ditentukan menjadi string aman, lalu menyimpan objek tersebut dalam variabel $Value. Perintah kedua menggunakan Get-Credential untuk mengumpulkan autentikasi Windows (nama pengguna dan kata sandi), lalu menyimpan objek PSCredential tersebut dalam variabel $Credential. Perintah ketiga membuat nilai terenkripsi untuk objek yang disimpan di $Value dan $Credential untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 4: Mengenkripsi kredensial untuk layanan tertaut HDFS

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

Perintah ConvertTo-SecureString mengonversi string yang ditentukan menjadi string aman. Perintah New-Object membuat objek PSCredential menggunakan string nama pengguna dan kata sandi yang aman. Sebagai gantinya, Anda dapat menggunakan perintah Get-Credential untuk mengumpulkan autentikasi Windows (nama pengguna dan kata sandi), lalu menyimpan objek PSCredential yang dikembalikan dalam variabel $credential seperti yang ditunjukkan pada contoh sebelumnya. Perintah New-AzDataFactoryEncryptValue membuat nilai terenkripsi untuk objek yang disimpan di $Credential untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 5: Mengenkripsi kredensial untuk layanan tertaut ODBC

$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

Perintah ConvertTo-SecureString mengonversi string yang ditentukan menjadi string aman. Perintah New-AzDataFactoryEncryptValue membuat nilai terenkripsi untuk objek yang disimpan di $Value untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Parameter

-AuthenticationType

Menentukan jenis autentikasi yang akan digunakan untuk menyambungkan ke sumber data. Nilai yang dapat diterima untuk parameter ini adalah:

Windows
Dasar
Anonim.

Type:	String
Accepted values:	Windows, Basic, Anonymous
Position:	6
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Menentukan kredensial autentikasi Windows (nama pengguna dan kata sandi) yang akan digunakan. Cmdlet ini mengenkripsi data kredensial yang Anda tentukan di sini.

Type:	PSCredential
Position:	3
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Menentukan nama database layanan tertaut.

Type:	String
Position:	8
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DataFactory

Menentukan objek PSDataFactory . Cmdlet ini mengenkripsi data untuk pabrik data yang ditentukan parameter ini.

Type:	PSDataFactory
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DataFactoryName

Menentukan nama pabrik data. Cmdlet ini mengenkripsi data untuk pabrik data yang ditentukan parameter ini.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-GatewayName

Menentukan nama gateway. Cmdlet ini mengenkripsi data untuk gateway yang ditentukan parameter ini.

Type:	String
Position:	2
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NonCredentialValue

Menentukan bagian non-kredensial dari string koneksi Open Database Connectivity (ODBC). Parameter ini hanya berlaku untuk layanan tertaut ODBC.

Type:	String
Position:	5
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Menentukan nama grup sumber daya Azure. Cmdlet ini mengenkripsi data untuk grup yang ditentukan parameter ini.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Server

Menentukan nama server layanan tertaut.

Type:	String
Position:	7
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Menentukan jenis layanan tertaut. Cmdlet ini mengenkripsi data untuk jenis layanan tertaut yang ditentukan parameter ini. Nilai yang dapat diterima untuk parameter ini adalah:

OnPremisesSqlLinkedService
OnPremisesFileSystemLinkedService
OnPremisesOracleLinkedService
OnPremisesOdbcLinkedService
OnPremisesPostgreSqlLinkedService
OnPremisesTeradataLinkedService
OnPremisesMySQLLinkedService
OnPremisesDB2LinkedService
OnPremisesSybaseLinkedService

Type:	String
Accepted values:	OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:	4
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

Menentukan nilai yang akan dienkripsi. Untuk layanan tertaut SQL Server lokal dan layanan tertaut Oracle lokal, gunakan string koneksi. Untuk layanan tertaut ODBC lokal, gunakan bagian kredensial dari string koneksi. Untuk layanan tertaut sistem file lokal, jika sistem file lokal ke komputer gateway, gunakan Lokal atau localhost, dan jika sistem file berada di server yang berbeda dari komputer gateway, gunakan \\servername.