Set-CMCloudManagementGateway

Módulo:

ConfigurationManager

Configuración de una puerta de enlace de administración en la nube (CMG).

Sintaxis

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -InputObject <IResultObject>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Id <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Name <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar una puerta de enlace de administración en la nube (CMG).

Para obtener más información, consulte Introducción a CMG.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Cambio de la configuración de alertas de CMG

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableTrafficOut $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90

Ejemplo 2: Cambio del número de máquinas virtuales para el servicio CMG

Este ejemplo tiene como destino la instancia de CMG denominada GraniteFalls y cambia el número de máquinas virtuales a 4.

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

Ejemplo 3: Habilitación de CMG para proporcionar contenido desde Azure Storage

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableCloudDPFunction $true

Ejemplo 4: Agregar dos nuevas entidades de certificación

$path1 = "folder\root.cer"
$type1 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA

$path2 = "folder\intermediate.cer"
$type2 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::IntermediateCA

$cert = @{$path1 = $type1; $path2 = $type2}

Set-CMCloudManagementGateway -Name "GraniteFalls" -CARootCert $cert

Ejemplo 5: Actualización del certificado de autenticación del servidor CMG

Este ejemplo tiene como destino la instancia de CMG denominada GraniteFalls y actualiza el certificado de autenticación del servidor CMG.

Set-CMCloudManagementGateway -Name "GraniteFalls" -ServiceCertPath "c:\TestPath\NewServiceCert.pfx" -ServiceCertPassword (ConvertTo-SecureString -String "tX*xJ11Nuo^B" -AsPlainText -Force)

Ejemplo 6: Quitar un certificado raíz de un CMG

Set-CMCloudManagementGateway -Name "GraniteFalls" -RemoveCertThumbprints "A7CBA0014DEF847593569D05003D5B96A1D6A627"

Parámetros

-CARootCert

Agregue certificados raíz al servicio en la nube.

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

-CheckClientCertRevocation

Establezca este parámetro true en para comprobar la revocación de certificados de cliente. Una lista de revocación de certificados (CRL) debe publicarse públicamente para que esta comprobación funcione. Para obtener más información, vea Publicar la lista de revocación de certificados.

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

-Confirm

Solicitará 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

-Description

Especifique una descripción opcional de este servicio CMG para identificarlo mejor.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-EnableCloudDPFunction

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción para permitir que CMG funcione como un punto de distribución de nube y sirva contenido de Azure Storage.

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

-EnableStorageQuota

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción Especificar umbral de alerta de almacenamiento.

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

-EnableTrafficOut

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción activar el umbral de 14 días y las alertas para supervisar la transferencia de datos salientes.

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

-EnforceProtocol

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción para aplicar TLS 1.2.

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

-Force

Ejecute el comando sin pedir confirmación. Si el certificado de servicio contiene varios nombres DNS, use este parámetro para evitar advertencias del cmdlet.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-Id

Especifique el identificador del sitio para el servicio de Azure. El identificador es el valor entero almacenado en la base de datos del sitio para el servicio. Por ejemplo, ejecute la siguiente consulta SQL y examine la columna id .: select * from Azure_CloudService.

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

-InputObject

Especifique un objeto CMG que se va a configurar. Para obtener este objeto, use el cmdlet Get-CMCloudManagementGateway .

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

-Name

Especifique el nombre de cmg que se va a configurar.

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

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

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

-RemoveCertThumbprints

Se aplica a la versión 2010 y versiones posteriores. Especifique una o varias huellas digitales de certificado para quitarlas como entidades de certificación raíz o intermedias de cmg.

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

-ServiceCertPassword

Se aplica a la versión 2006 y versiones posteriores. Especifique la contraseña del certificado en -ServiceCertPath.

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

-ServiceCertPath

Se aplica a la versión 2006 y versiones posteriores. Especifique la ruta de acceso al certificado de servicio. Para obtener más información, consulte Certificado de autenticación de servidor CMG.

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

-StorageCriticalPct

Se aplica a la versión 2010 y versiones posteriores. Especifique un valor entero para la alerta Generar crítica (% del umbral de alerta de almacenamiento). Por ejemplo, 90.

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

-StorageQuotaGB

Se aplica a la versión 2010 y versiones posteriores. Especifique un valor entero para el umbral de alerta de almacenamiento (GB). Por ejemplo, 2.

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

-StorageWarningPct

Se aplica a la versión 2010 y versiones posteriores. Especifique un valor entero para la alerta Generar advertencia (% del umbral de alerta de almacenamiento). Por ejemplo, 50.

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

-TrafficCriticalPct

Si habilita alertas para supervisar la transferencia de datos salientes, especifique el porcentaje de umbral para generar una alerta crítica . Este valor es 90 de forma predeterminada.

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

-TrafficOutGB

Si habilita alertas de almacenamiento, use este parámetro para especificar el umbral de alerta de almacenamiento en GB. El valor predeterminado es 2.

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

-TrafficOutStopService

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción detener este servicio cuando se supere el umbral crítico.

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

-TrafficWarningPct

Si habilita alertas para supervisar la transferencia de datos salientes, especifique el porcentaje de umbral para generar una alerta de advertencia . Este valor es 50 de forma predeterminada.

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

-VMInstanceCount

Se aplica a la versión 2010 y versiones posteriores. Especifique el recuento de instancias de máquinas virtuales.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. 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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Get-CMCloudManagementGateway
• New-CMCloudManagementGateway
• Remove-CMCloudManagementGateway
• Start-CMCloudManagementGateway
• Stop-CMCloudManagementGateway
• Introducción a CMG