New-AzDataFactoryEncryptValue
Verschlüsselt vertrauliche Daten.
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>]
Beschreibung
Das Cmdlet New-AzDataFactoryEncryptValue verschlüsselt vertrauliche Daten, z. B. ein Kennwort oder ein Microsoft SQL Server-Verbindungszeichenfolge, und gibt einen verschlüsselten Wert zurück.
Beispiele
Beispiel 1: Verschlüsseln eines nicht ODBC-Verbindungszeichenfolge
$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
Der erste Befehl verwendet das Cmdlet ConvertTo-SecureString, um die angegebene Verbindungszeichenfolge in ein SecureString-Objekt zu konvertieren, und speichert dieses Objekt dann in der $Value Variablen.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help ConvertTo-SecureString
.
Zulässige Werte: SQL Server oder Oracle Verbindungszeichenfolge.
Der zweite Befehl erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.
Beispiel 2: Verschlüsseln einer nicht ODBC-Verbindungszeichenfolge, die Windows-Authentifizierung verwendet.
$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
Der erste Befehl verwendet ConvertTo-SecureString, um die angegebene Verbindungszeichenfolge in ein sicheres Zeichenfolgenobjekt zu konvertieren, und speichert dieses Objekt dann in der $Value Variablen.
Der zweite Befehl verwendet das Cmdlet "Get-Credential", um die Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln, und speichert dann das PSCredential-Objekt in der $Credential Variablen.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential
.
Der dritte Befehl erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt und $Credential für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.
Beispiel 3: Verschlüsseln des Servernamens und der Anmeldeinformationen für den verknüpften Dateisystemdienst
$Value = ConvertTo-SecureString '\\servername' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesFileSystemLinkedService
Der erste Befehl verwendet ConvertTo-SecureString , um die angegebene Zeichenfolge in eine sichere Zeichenfolge zu konvertieren, und speichert das Objekt dann in der $Value Variablen. Der zweite Befehl verwendet Get-Credential, um die Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln, und speichert dann das PSCredential-Objekt in der $Credential Variablen. Der dritte Befehl erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt und $Credential für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.
Beispiel 4: Verschlüsseln von Anmeldeinformationen für den verknüpften HDFS-Dienst
$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"
Der Befehl ConvertTo-SecureString konvertiert die angegebene Zeichenfolge in eine sichere Zeichenfolge. Der Befehl "New-Object " erstellt ein PSCredential-Objekt mithilfe der sicheren Benutzernamen- und Kennwortzeichenfolgen. Stattdessen können Sie den Befehl "Get-Credential" verwenden, um Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln und dann das zurückgegebene PSCredential-Objekt in der $credential Variablen zu speichern, wie in den vorherigen Beispielen gezeigt. Der Befehl "New-AzDataFactoryEncryptValue " erstellt einen verschlüsselten Wert für das in $Credential gespeicherte Objekt für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.
Beispiel 5: Verschlüsseln von Anmeldeinformationen für odbc-verknüpften Dienst
$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
Der Befehl ConvertTo-SecureString konvertiert die angegebene Zeichenfolge in eine sichere Zeichenfolge. Der Befehl "New-AzDataFactoryEncryptValue " erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.
Parameter
-AuthenticationType
Gibt den Typ der Authentifizierung an, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll. Zulässige Werte für diesen Parameter:
- Windows
- Grundlegend
- Anonym.
Type: | String |
Accepted values: | Windows, Basic, Anonymous |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Gibt die Windows-Authentifizierung Anmeldeinformationen (Benutzername und Kennwort) an, die verwendet werden sollen. Dieses Cmdlet verschlüsselt die hier angegebenen Anmeldeinformationsdaten.
Type: | PSCredential |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
Gibt den Datenbanknamen des verknüpften Diensts an.
Type: | String |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DataFactory
Gibt ein PSDataFactory -Objekt an. Dieses Cmdlet verschlüsselt Daten für die Datenfactory, die dieser Parameter angibt.
Type: | PSDataFactory |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DataFactoryName
Gibt den Namen einer Datenfactory an. Dieses Cmdlet verschlüsselt Daten für die Datenfactory, die dieser Parameter angibt.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewayName
Gibt den Namen des Gateways an. Dieses Cmdlet verschlüsselt Daten für das Gateway, das dieser Parameter angibt.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NonCredentialValue
Gibt den Nicht-Anmeldeinformationsteil des ODBC-Verbindungszeichenfolge (Open Database Verbinden ivity) an. Dieser Parameter gilt nur für den ODBC-verknüpften Dienst.
Type: | String |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Gibt den Namen einer Azure-Ressourcengruppe an. Dieses Cmdlet verschlüsselt Daten für die Gruppe, die dieser Parameter angibt.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Server
Gibt den Servernamen des verknüpften Diensts an.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Type
Gibt den verknüpften Diensttyp an. Dieses Cmdlet verschlüsselt Daten für den verknüpften Diensttyp, den dieser Parameter angibt. Zulässige Werte für diesen Parameter:
- 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
Gibt den zu verschlüsselnden Wert an. Verwenden Sie für einen lokalen sql Server-verknüpften Dienst und einen lokalen Oracle-verknüpften Dienst eine Verbindungszeichenfolge. Verwenden Sie für einen lokalen ODBC-verknüpften Dienst den Anmeldeinformationsteil des Verbindungszeichenfolge. Wenn das Dateisystem lokal auf dem Gatewaycomputer lokal ist, verwenden Sie "Local" oder "localhost", und wenn sich das Dateisystem auf einem Server befindet, der sich vom Gatewaycomputer unterscheidet, verwenden Sie "\\servername".
Type: | SecureString |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Ausgaben
Hinweise
- Schlüsselwörter: azure, azurerm, arm, resource, management, manager, data, factories
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für