New-AzDataFactoryEncryptValue

  • Referentie
Module:
Az.DataFactory

Versleutelt gevoelige gegevens.

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

De cmdlet New-AzDataFactoryEncryptValue versleutelt gevoelige gegevens, zoals een wachtwoord of een Microsoft SQL Server-verbindingsreeks, en retourneert een versleutelde waarde.

Voorbeelden

Voorbeeld 1: Een niet-ODBC-verbindingsreeks versleutelen

$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

De eerste opdracht maakt gebruik van de cmdlet ConvertTo-SecureString om de opgegeven verbindingsreeks te converteren naar een SecureString-object en slaat dat object vervolgens op in de $Value variabele. Typ voor meer informatie Get-Help ConvertTo-SecureString. Toegestane waarden: SQL Server of Oracle verbindingsreeks. Met de tweede opdracht maakt u een versleutelde waarde voor het object dat is opgeslagen in $Value voor de opgegeven data factory, gateway, resourcegroep en gekoppeld servicetype.

Voorbeeld 2: een niet-ODBC-verbindingsreeks versleutelen die gebruikmaakt van Windows-verificatie.

$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

De eerste opdracht maakt gebruik van ConvertTo-SecureString om de opgegeven verbindingsreeks te converteren naar een beveiligd tekenreeksobject en slaat dat object vervolgens op in de $Value variabele. De tweede opdracht maakt gebruik van de cmdlet Get-Credential om de Windows-verificatie (gebruikersnaam en wachtwoord) te verzamelen en slaat vervolgens dat PSCredential-object op in de variabele $Credential. Typ voor meer informatie Get-Help Get-Credential. Met de derde opdracht maakt u een versleutelde waarde voor het object dat is opgeslagen in $Value en $Credential voor de opgegeven data factory, gateway, resourcegroep en gekoppeld servicetype.

Voorbeeld 3: Servernaam en -referenties versleutelen voor gekoppelde bestandssysteemservice

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

De eerste opdracht maakt gebruik van ConvertTo-SecureString om de opgegeven tekenreeks te converteren naar een beveiligde tekenreeks en slaat dat object vervolgens op in de $Value variabele. De tweede opdracht maakt gebruik van Get-Credential om de Windows-verificatie (gebruikersnaam en wachtwoord) te verzamelen en slaat vervolgens dat PSCredential-object op in de variabele $Credential. Met de derde opdracht maakt u een versleutelde waarde voor het object dat is opgeslagen in $Value en $Credential voor de opgegeven data factory, gateway, resourcegroep en gekoppeld servicetype.

Voorbeeld 4: Referenties versleutelen voor gekoppelde HDFS-service

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

Met de opdracht ConvertTo-SecureString wordt de opgegeven tekenreeks geconverteerd naar een beveiligde tekenreeks. Met de opdracht New-Object maakt u een PSCredential-object met behulp van de beveiligde tekenreeksen voor gebruikersnaam en wachtwoord. In plaats daarvan kunt u de opdracht Get-Credential gebruiken om Windows-verificatie (gebruikersnaam en wachtwoord) te verzamelen en vervolgens het geretourneerde PSCredential-object op te slaan in de variabele $credential, zoals wordt weergegeven in de vorige voorbeelden. Met de opdracht New-AzDataFactoryEncryptValue maakt u een versleutelde waarde voor het object dat is opgeslagen in $Credential voor de opgegeven data factory, gateway, resourcegroep en gekoppeld servicetype.

Voorbeeld 5: Referenties versleutelen voor de gekoppelde ODBC-service

$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

Met de opdracht ConvertTo-SecureString wordt de opgegeven tekenreeks geconverteerd naar een beveiligde tekenreeks. Met de opdracht New-AzDataFactoryEncryptValue maakt u een versleutelde waarde voor het object dat is opgeslagen in $Value voor de opgegeven data factory, gateway, resourcegroep en gekoppeld servicetype.

Parameters

-AuthenticationType

Hiermee geeft u het type verificatie dat moet worden gebruikt om verbinding te maken met de gegevensbron. De aanvaardbare waarden voor deze parameter zijn:

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

-Credential

Hiermee geeft u de Windows-verificatiereferenties (gebruikersnaam en wachtwoord) op die moeten worden gebruikt. Deze cmdlet versleutelt de referentiegegevens die u hier opgeeft.

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

-Database

Hiermee geeft u de databasenaam van de gekoppelde service.

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

-DataFactory

Hiermee geeft u een PSDataFactory-object . Met deze cmdlet worden gegevens versleuteld voor de data factory die met deze parameter wordt opgegeven.

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

-DataFactoryName

Hiermee geeft u de naam van een data factory. Met deze cmdlet worden gegevens versleuteld voor de data factory die met deze parameter wordt opgegeven.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

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

-GatewayName

Hiermee geeft u de naam van de gateway. Met deze cmdlet worden gegevens versleuteld voor de gateway die met deze parameter wordt opgegeven.

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

-NonCredentialValue

Hiermee geeft u het niet-referentiegedeelte van de ODBC-verbindingsreeks (Open Database Verbinding maken ivity) op. Deze parameter is alleen van toepassing op de gekoppelde ODBC-service.

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

-ResourceGroupName

Hiermee geeft u de naam van een Azure-resourcegroep op. Met deze cmdlet worden gegevens versleuteld voor de groep die met deze parameter wordt opgegeven.

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

-Server

Hiermee geeft u de servernaam van de gekoppelde service.

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

-Type

Hiermee geeft u het gekoppelde servicetype op. Met deze cmdlet worden gegevens versleuteld voor het gekoppelde servicetype dat met deze parameter wordt opgegeven. De aanvaardbare waarden voor deze parameter zijn:

  • 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Hiermee geeft u de waarde die moet worden versleuteld. Gebruik een verbindingsreeks voor een gekoppelde on-premises SQL Server-service en een on-premises Oracle-gekoppelde service. Gebruik het referentiegedeelte van de verbindingsreeks voor een gekoppelde on-premises ODBC-service. Als voor de gekoppelde on-premises bestandssysteemservice het bestandssysteem lokaal is op de gatewaycomputer, gebruikt u Local of localhost en gebruikt u \\servername als het bestandssysteem zich op een andere server bevindt dan de gatewaycomputer.

Type:SecureString
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSDataFactory

String

Uitvoerwaarden

String

Notities

  • Trefwoorden: azure, azurerm, arm, resource, beheer, manager, gegevens, factory's