Freigeben über

Set-AzHDInsightGatewayCredential

Modul:
Az.HDInsight Module

Legt die HTTP-Anmeldeinformationen des Gateways eines Azure HDInsight-Clusters fest.

Syntax

SetByNameParameterSet (Standard) 

Set-AzHDInsightGatewayCredential
    [-Name] <String>
    [[-HttpCredential] <PSCredential>]
    [-ResourceGroupName <String>]
    [-EntraUserIdentity <String[]>]
    [-EntraUserFullInfo <Hashtable[]>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByInputObjectParameterSet 

Set-AzHDInsightGatewayCredential
    [[-HttpCredential] <PSCredential>]
    -InputObject <AzureHDInsightCluster>
    [-EntraUserIdentity <String[]>]
    [-EntraUserFullInfo <Hashtable[]>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdParameterSet 

Set-AzHDInsightGatewayCredential
    [[-HttpCredential] <PSCredential>]
    -ResourceId <String>
    [-EntraUserIdentity <String[]>]
    [-EntraUserFullInfo <Hashtable[]>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzHDInsightGatewayCredential legt Gatewayanmeldeinformationen eines Azure HDInsight-Clusters fest.

Beispiele

Beispiel 1: Festlegen von Gatewayanmeldeinformationen für einen HDInsight-Cluster nach Name-Parametersatz

# Cluster info
$clusterName = "your-hadoop-001"
$clusterCreds = Get-Credential

Set-AzHDInsightGatewayCredential `
            -ClusterName $clusterName `
            -HttpCredential $clusterCreds

Beispiel 2: Festlegen von Gatewayanmeldeinformationen für einen HDInsight-Cluster nach ResourceId-Parametersatz

Set-AzHDInsightGatewayCredential `
            -ResourceId "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusters/your-hadoop-001" `
            -HttpCredential $clusterCreds

Beispiel 3: Festlegen von Gatewayanmeldeinformationen für einen HDInsight-Cluster nach InputObject-Parametersatz

# Cluster info
$clusterName = "your-hadoop-001"
$clusterCreds = Get-Credential

Get-AzHDInsightCluster -ClusterName $clusterName | Set-AzHDInsightGatewayCredential `
            -HttpCredential $clusterCreds

Beispiel 4: Festlegen von Gateway-Entra-Benutzern für einen HDInsight-Cluster durch EntraUser Full Info

# Cluster info
$clusterName = "your-hadoop-001"
$entraUserFullInfo = @(@{ObjectId = "ObjectId1"; Upn = "Upn1"; DisplayName = "DisplayName1"},@{ObjectId = "ObjectId2"; Upn = "Upn2"; DisplayName = "DisplayName2"})

Set-AzHDInsightGatewayCredential `
            -ClusterName $clusterName `
            -EntraUserFullInfo $entraUserFullInfo

Um den parameter -EntraUserFullInfo zu verwenden, müssen Sie die ObjectId, Upn und DisplayName jedes Benutzers angeben. Diese Informationen können entweder über das Azure-Portal abgerufen werden, indem Sie das Profil des Benutzers unter Microsoft Entra ID-Benutzer > anzeigen oder programmgesteuert das Cmdlet Get-AzADUser aus dem Az.Resources-Modul in PowerShell verwenden. Beispiel: Get-AzADUser -UserPrincipalName "user@contoso.com" Gibt Felder wie Id (ObjectId), UserPrincipalName (Upn) und DisplayName zurück. Weitere Informationen finden Sie in der offiziellen Dokumentation: Get-AzADUser.

Beispiel 5: Festlegen von Gateway-Entra-Benutzern für einen HDInsight-Cluster nach ObjectId oder Upn

# Cluster info
$clusterName = "your-hadoop-001"
$entraUserIdentity = @("user1@contoso.com","user2@contoso.com","objectid3","objectid4")

Set-AzHDInsightGatewayCredential `
            -ClusterName $clusterName `
            -EntraUserIdentity $entraUserIdentity

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EntraUserFullInfo

Dient zum Abrufen oder Festlegen einer Liste von Entra-Benutzern als Array von Hashtables. Jede Hashtabelle sollte Schlüssel wie ObjectId, Upn und DisplayName enthalten.

Parametereigenschaften

Typ:

Hashtable[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EntraUserIdentity

Ruft die Entra-Benutzerdaten ab oder legt sie fest. Akzeptiert mindestens einen ObjectId/Upn-Wert.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HttpCredential

Ruft die Anmeldung für den Benutzer des Clusters ab oder legt sie fest.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-InputObject

Ruft ab oder legt das Eingabeobjekt fest.

Parametereigenschaften

Typ:AzureHDInsightCluster
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByInputObjectParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Ruft den Namen des Clusters ab oder legt den Namen fest.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Clustername

Parametersätze

SetByNameParameterSet
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Dient zum Abrufen oder Festlegen des Namens der Ressourcengruppe.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceId

Ruft die Ressourcen-ID ab oder legt sie fest.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResourceIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

AzureHDInsightGatewaySettings