Delen via


New-AzDataFactoryEncryptValue

Versleutelt gevoelige gegevens.

Syntax

ByFactoryName (Standaard)

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

ByFactoryObject

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=******' -AsPlainText -Force
New-AzDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

De eerste opdracht maakt gebruik van de ConvertTo-SecureString cmdlet 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 -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

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 Get-Credential cmdlet voor het verzamelen van de Windows-verificatie (gebruikersnaam en wachtwoord) en slaat vervolgens dat PSCredential-object op in de $Credential variabele. 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 "******" -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 "******" -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"

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=******;" -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 acceptabele waarden voor deze parameter zijn:

  • Windows
  • Eenvoudig
  • Anoniem.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Windows, Basic, Anonymous
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:6
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:3
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Database

Hiermee geeft u de databasenaam van de gekoppelde service.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:8
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DataFactory

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

Parametereigenschappen

Type:PSDataFactory
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFactoryObject
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFactoryName
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NonCredentialValue

Hiermee geeft u het niet-referentiedeel van de ODBC-verbindingsreeks (Open Database Connectivity) op. Deze parameter is alleen van toepassing op de gekoppelde ODBC-service.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:5
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFactoryName
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Server

Hiermee geeft u de servernaam van de gekoppelde service.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:7
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 acceptabele waarden voor deze parameter zijn:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:4
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 Gekoppelde Oracle-service. Gebruik voor een on-premises ODBC-gekoppelde service het referentiegedeelte van de verbindingsreeks. 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.

Parametereigenschappen

Type:SecureString
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSDataFactory

String

Uitvoerwaarden

String

Notities

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