Set-AzHDInsightGatewayCredential

Модуль:
Az.HDInsight Module

Задает учетные данные HTTP шлюза кластера Azure HDInsight.

Синтаксис

SetByNameParameterSet (По умолчанию) 

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

Описание

Командлет Set-AzHDInsightGatewayCredential задает учетные данные шлюза кластера Azure HDInsight.

Примеры

Пример 1. Задание учетных данных шлюза для кластера HDInsight по набору параметров имени

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

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

Пример 2. Установка учетных данных шлюза для кластера HDInsight по набору параметров ResourceId

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

Пример 3. Установка учетных данных шлюза для кластера HDInsight с помощью набора параметров InputObject

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

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

Пример 4. Настройка пользователей шлюза Entra Users for a HDInsight Cluster by 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

Чтобы использовать параметр -EntraUserFullInfo, необходимо указать идентификатор объекта каждого пользователя, upn и DisplayName. Эти сведения можно получить с помощью портал Azure путем просмотра профиля пользователя в разделе Microsoft Entra ID > Users или программно с помощью командлета Get-AzADUser из модуля Az.Resources в PowerShell. Например, Get-AzADUser -UserPrincipalName "user@contoso.com" возвращает такие поля, как Id (ObjectId), UserPrincipalName (Upn) и DisplayName. Дополнительные сведения см. в официальной документации: Get-AzADUser.

Пример 5. Настройка пользователей шлюза Entra для кластера HDInsight с помощью ObjectId или Upn

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

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

Параметры

-AsJob

Запустите командлет в фоновом режиме.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Свойства параметров

Тип:IAzureContextContainer
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EntraUserFullInfo

Возвращает или задает список пользователей Entra в виде массива хэш-списков. Каждый хэш-файл должен содержать такие ключи, как ObjectId, Upn и DisplayName.

Свойства параметров

Тип:

Hashtable[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EntraUserIdentity

Возвращает или задает данные пользователя Entra. Принимает одно или несколько значений ObjectId/Upn.

Свойства параметров

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-HttpCredential

Возвращает или задает имя входа для пользователя кластера.

Свойства параметров

Тип:PSCredential
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-InputObject

Возвращает или задает входной объект.

Свойства параметров

Тип:AzureHDInsightCluster
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByInputObjectParameterSet
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Возвращает или задает имя кластера.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Название кластера

Наборы параметров

SetByNameParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceGroupName

Возвращает или задает имя группы ресурсов.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByNameParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceId

Возвращает или задает идентификатор ресурса.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceIdParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

None

Выходные данные

AzureHDInsightGatewaySettings