Compartir a través de


Set-AzConnectedKubernetes

API para establecer propiedades del recurso de clúster conectado

Sintaxis

Set-AzConnectedKubernetes
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   -Location <String>
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-OidcIssuerProfileEnabled]
   [-OidcIssuerProfileSelfHostedIssuerUrl <String>]
   [-WorkloadIdentityEnabled]
   [-AcceptEULA]
   [-ConfigurationSetting <Hashtable>]
   [-ConfigurationProtectedSetting <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzConnectedKubernetes
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   -Location <String>
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-OidcIssuerProfileEnabled]
   [-OidcIssuerProfileSelfHostedIssuerUrl <String>]
   [-WorkloadIdentityEnabled]
   [-AcceptEULA]
   [-ConfigurationSetting <Hashtable>]
   [-ConfigurationProtectedSetting <Hashtable>]
   [-DisableGateway]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzConnectedKubernetes
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   -Location <String>
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-OidcIssuerProfileEnabled]
   [-OidcIssuerProfileSelfHostedIssuerUrl <String>]
   [-WorkloadIdentityEnabled]
   [-AcceptEULA]
   [-ConfigurationSetting <Hashtable>]
   [-ConfigurationProtectedSetting <Hashtable>]
   -GatewayResourceId <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzConnectedKubernetes
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-OidcIssuerProfileEnabled]
   [-OidcIssuerProfileSelfHostedIssuerUrl <String>]
   [-WorkloadIdentityEnabled]
   [-AcceptEULA]
   [-ConfigurationSetting <Hashtable>]
   [-ConfigurationProtectedSetting <Hashtable>]
   -GatewayResourceId <String>
   -InputObject <IConnectedCluster>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzConnectedKubernetes
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-OidcIssuerProfileEnabled]
   [-OidcIssuerProfileSelfHostedIssuerUrl <String>]
   [-WorkloadIdentityEnabled]
   [-AcceptEULA]
   [-ConfigurationSetting <Hashtable>]
   [-ConfigurationProtectedSetting <Hashtable>]
   [-DisableGateway]
   -InputObject <IConnectedCluster>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzConnectedKubernetes
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-OidcIssuerProfileEnabled]
   [-OidcIssuerProfileSelfHostedIssuerUrl <String>]
   [-WorkloadIdentityEnabled]
   [-AcceptEULA]
   [-ConfigurationSetting <Hashtable>]
   [-ConfigurationProtectedSetting <Hashtable>]
   -InputObject <IConnectedCluster>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

API para establecer propiedades del recurso de clúster conectado. Reemplaza toda la configuración de un clúster conectado existente; las propiedades no especificadas se restablecerán a sus valores predeterminados.

Ejemplos

Ejemplo 1: Deshabilitación de la puerta de enlace para un clúster de Kubernetes conectado

Set-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -DisableGateway

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Este comando deshabilita la característica de puerta de enlace de un clúster de Kubernete conectado.

Ejemplo 2: Habilitación de la puerta de enlace para un clúster de Kubernetes conectado

Set-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -GatewayResourceId $gatewayResourceId

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Este comando habilita la característica de puerta de enlace de un clúster de Kubernetes conectado.

Ejemplo 3: Habilitación de la puerta de enlace para un clúster de Kubernetes conectado con InputObject

# Get an existing cluster first
$inputObject = Get-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SubscriptionId $subscriptionId
# Enable gateway and set gateway resource Id 
$inputObject.GatewayEnabled=$true
$inputObject.GatewayResourceId=$gatewayResourceId
Set-AzConnectedKubernetes -InputObject $inputObject

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Este comando habilita la característica de puerta de enlace de un clúster de Kubernetes conectado.

Ejemplo 4: Habilitación de la identidad de carga de trabajo de un clúster de Kubernetes conectado con InputObject

# Get an existing cluster first
$inputObject = Get-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SubscriptionId $subscriptionId
# Enable workload identity and OIDC issuer profile
$inputObject.WorkloadIdentityEnabled=$true
$inputObject.OidcIssuerProfileEnabled=$true
Set-AzConnectedKubernetes -InputObject $inputObject

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Este comando habilita la identidad de carga de trabajo y el perfil de emisor de OIDC para un clúster de Kubernetes conectado.

Ejemplo 5: Deshabilitar la identidad de carga de trabajo de un clúster de Kubernetes conectado con InputOjbect

# Get an existing cluster first
$inputObject = Get-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SubscriptionId $subscriptionId
# Disable workload identity 
$inputObject.WorkloadIdentityEnabled=$falue
Set-AzConnectedKubernetes -InputObject $inputObject

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Este comando deshabilita la identidad de carga de trabajo de un clúster de Kubernetes conectado.

Ejemplo 6: Deshabilitación de la identidad de carga de trabajo de un clúster de Kubernetes conectado

Get-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SubscriptionId $subscriptionId | Set-AzConnectedKubernetes -WorkloadIdentityEnabled:$false

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Este comando deshabilita la identidad de carga de trabajo de un clúster de Kubernetes conectado.

Parámetros

-AcceptEULA

Aceptar EULA de ConnectedKubernetes, el término legal aparecerá sin este parámetro proporcionado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecución del comando como trabajo

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AzureHybridBenefit

Indica si se ha optado por la Ventaja híbrida de Azure.

Tipo:AzureHybridBenefit
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClusterName

Nombre del clúster de Kubernetes en el que se llama a get.

Tipo:String
Alias:Name
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConfigurationProtectedSetting

Configuración protegida por el sistema de agente de Arc

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConfigurationSetting

Configuración del sistema de agente de Arc

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ContainerLogPath

Invalide la ruta de acceso del registro de contenedor predeterminada para habilitar el registro de fluent-bit.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomLocationsOid

OID de la aplicación "ubicaciones personalizadas".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableAutoUpgrade

Marca para deshabilitar la actualización automática de agentes de arc.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableGateway

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Distribution

La distribución de Kubernetes que se ejecuta en este clúster conectado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DistributionVersion

La versión de distribución de Kubernetes en este clúster conectado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GatewayResourceId

Identificador de recurso de Puerta de enlace de Arc, lo que proporciona esto habilitará la puerta de enlace.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HttpProxy

URI http del servidor proxy para el clúster de Kubernetes que se va a usar

Tipo:Uri
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HttpsProxy

URI https del servidor proxy para el clúster de Kubernetes que se va a usar

Tipo:Uri
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Infrastructure

La infraestructura en la que se ejecuta el clúster de Kubernetes representado por este clúster conectado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Para construir, vea la sección NOTES para las propiedades INPUTOBJECT y crear una tabla hash.

Tipo:IConnectedCluster
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-KubeConfig

Ruta de acceso al archivo de configuración kube

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KubeContext

Contexto de Kubconfig desde la máquina actual

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Ubicación geográfica donde reside el recurso

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoProxy

Lista separada por comas de nombres de host que se deben excluir del servidor proxy para que use el clúster de Kubernetes.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OidcIssuerProfileEnabled

Si se va a habilitar el emisor oidc para la integración de identidades de carga de trabajo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OidcIssuerProfileSelfHostedIssuerUrl

La dirección URL del emisor para clústeres de nube pública ( AKS, EKS, GKE) que se usa para la característica de identidad de carga de trabajo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrivateLinkScopeResourceId

El identificador de recurso del ámbito de vínculo privado al que se asigna este clúster conectado, si existe.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrivateLinkState

Propiedad que describe el estado del vínculo privado en un recurso de clúster conectado.

Tipo:PrivateLinkState
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProvisioningState

Estado de aprovisionamiento del recurso de clúster conectado.

Tipo:ProvisioningState
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProxyCert

Ruta de acceso al archivo de certificado para proxy o entidad de certificación personalizada.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubscriptionId

Identificador de la suscripción de destino.

Tipo:String
Posición:Named
Valor predeterminado:(Get-AzContext).Subscription.Id
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tag

Etiquetas de recursos.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WorkloadIdentityEnabled

Habilitación del webhook de identidad de carga de trabajo

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

IConnectedCluster

Salidas

IConnectedCluster