Udostępnij przez

Set-AzHDInsightGatewayCredential

Moduł:
Az.HDInsight Module

Ustawia poświadczenia HTTP bramy klastra usługi Azure HDInsight.

Składnia

SetByNameParameterSet (domyślnie) 

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

Opis

Polecenie cmdlet Set-AzHDInsightGatewayCredential ustawia poświadczenia bramy klastra usługi Azure HDInsight.

Przykłady

Przykład 1: Ustawianie poświadczeń bramy dla klastra usługi HDInsight według zestawu parametrów nazw

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

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

Przykład 2. Ustawianie poświadczeń bramy dla klastra usługi HDInsight według zestawu parametrów ResourceId

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

Przykład 3. Ustawianie poświadczeń bramy dla klastra usługi HDInsight według zestawu parametrów InputObject

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

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

Przykład 4. Ustawianie użytkowników entra bramy dla klastra usługi HDInsight przez entraUser — pełne informacje

# 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

Aby użyć parametru -EntraUserFullInfo, należy podać wartości ObjectId, Upn i DisplayName każdego użytkownika. Te informacje można uzyskać za pośrednictwem witryny Azure Portal , wyświetlając profil użytkownika w obszarze Użytkownicy identyfikatora > entra firmy Microsoft lub programowo przy użyciu polecenia cmdlet Get-AzADUser z modułu Az.Resources w programie PowerShell. Na przykład: Get-AzADUser -UserPrincipalName "user@contoso.com" zwraca pola, takie jak Id (ObjectId), UserPrincipalName (Upn) i DisplayName. Aby uzyskać więcej informacji, zapoznaj się z oficjalną dokumentacją: Get-AzADUser.

Przykład 5. Ustawianie użytkowników entra bramy dla klastra usługi HDInsight według identyfikatora ObjectId lub upn

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

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

Parametry

-AsJob

Uruchom polecenie cmdlet w tle.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EntraUserFullInfo

Pobiera lub ustawia listę użytkowników Entra jako tablicę tabel skrótów. Każda tabela skrótu powinna zawierać klucze, takie jak ObjectId, Upn i DisplayName.

Właściwości parametru

Typ:

Hashtable[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EntraUserIdentity

Pobiera lub ustawia dane użytkownika Entra. Akceptuje co najmniej jedną wartość ObjectId/Upn.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HttpCredential

Pobiera lub ustawia identyfikator logowania użytkownika klastra.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-InputObject

Pobiera lub ustawia obiekt wejściowy.

Właściwości parametru

Typ:AzureHDInsightCluster
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByInputObjectParameterSet
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Pobiera lub ustawia nazwę klastra.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Nazwa klastra

Zestawy parametrów

SetByNameParameterSet
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Pobiera lub ustawia nazwę grupy zasobów.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByNameParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceId

Pobiera lub ustawia identyfikator zasobu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceIdParameterSet
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

AzureHDInsightGatewaySettings