Set-CMCloudManagementGateway

Referência

Módulo:: ConfigurationManager

Configurar um gateway de gestão da cloud (CMG).

Sintaxe

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

Utilize este cmdlet para configurar um gateway de gestão da cloud (CMG).

Para obter mais informações, veja CmG Overview (Descrição Geral do CMG).

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Alterar a configuração dos alertas CMG

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

Exemplo 2: Alterar o número de máquinas virtuais para o serviço CMG

Este exemplo destina-se ao CMG denominado GraniteFalls e altera o número de VMs para 4.

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

Exemplo 3: Ativar o CMG para servir conteúdos do armazenamento do Azure

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

Exemplo 4: Adicionar duas novas autoridades de certificação

$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

Exemplo 5: Atualizar o certificado de autenticação do servidor CMG

Este exemplo destina-se ao CMG denominado GraniteFalls e atualiza o certificado de autenticação do servidor CMG.

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

Exemplo 6: Remover um certificado de raiz de um CMG

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

Parâmetros

-CARootCert

Adicione certificados de raiz ao serviço cloud.

Tipo:	Hashtable
Aliases:	CARootCertificate, CARootCertificates
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CheckClientCertRevocation

Defina este parâmetro como true para verificar a revogação do certificado de cliente. Uma lista de revogação de certificados (CRL) tem de ser publicada publicamente para que esta verificação funcione. Para obter mais informações, veja Publicar a lista de revogação de certificados.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Description

Especifique uma descrição opcional deste serviço CMG para o identificar melhor.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableCloudDPFunction

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Permitir que o CMG funcione como um ponto de distribuição na cloud e sirva conteúdos do armazenamento do Azure.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableStorageQuota

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Especificar o limiar de alerta de armazenamento.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableTrafficOut

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Ativar o limiar de 14 dias e alertas para monitorizar a transferência de dados de saída.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnforceProtocol

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Impor o TLS 1.2.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Execute o comando sem pedir confirmação. Se o certificado de serviço contiver vários nomes DNS, utilize este parâmetro para evitar avisos do cmdlet .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Id

Especifique o ID do site para o serviço do Azure. O ID é o valor inteiro armazenado na base de dados do site do serviço. Por exemplo, execute a seguinte consulta SQL e observe a coluna ID : select * from Azure_CloudService.

Tipo:	String
Aliases:	AzureServiceId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifique um objeto CMG a configurar. Para obter este objeto, utilize o cmdlet Get-CMCloudManagementGateway .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifique o nome do CMG a configurar.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveCertThumbprints

Aplica-se à versão 2010 e posterior. Especifique um ou mais thumbprints de certificado para removê-los como autoridades de certificação de raiz ou intermédias do CMG.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServiceCertPassword

Aplica-se à versão 2006 e posterior. Especifique a palavra-passe do certificado no -ServiceCertPath.

Tipo:	SecureString
Aliases:	ServiceCertificatePassword
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServiceCertPath

Aplica-se à versão 2006 e posterior. Especifique o caminho para o certificado de serviço. Para obter mais informações, veja Certificado de autenticação do servidor CMG.

Tipo:	String
Aliases:	ServiceCertificatePath
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageCriticalPct

Aplica-se à versão 2010 e posterior. Especifique um valor inteiro para o alerta Gerar Crítico (% do limiar de alerta de armazenamento). Por exemplo, 90.

Tipo:	Int32
Aliases:	StorageCriticalPercent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageQuotaGB

Aplica-se à versão 2010 e posterior. Especifique um valor inteiro para o limiar de alerta de Armazenamento (GB). Por exemplo, 2.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageWarningPct

Aplica-se à versão 2010 e posterior. Especifique um valor inteiro para o alerta Gerar Aviso (% do limiar de alerta de armazenamento). Por exemplo, 50.

Tipo:	Int32
Aliases:	StorageWarningPercent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficCriticalPct

Se ativar alertas para monitorizar a transferência de dados de saída, especifique a percentagem de limiar para gerar um alerta Crítico . Este valor é 90 por predefinição.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficOutGB

Se ativar os alertas de armazenamento, utilize este parâmetro para especificar o limiar de alerta de armazenamento em GB. O valor padrão é 2.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficOutStopService

Aplica-se à versão 2010 e posterior. Ative ou desative a opção Parar este serviço quando o limiar crítico for excedido.

Tipo:	Boolean
Aliases:	StopTrafficOutService
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficWarningPct

Se ativar alertas para monitorizar a transferência de dados de saída, especifique a percentagem de limiar para gerar um alerta de Aviso . Este valor é 50 por predefinição.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-VMInstanceCount

Aplica-se à versão 2010 e posterior. Especifique a contagem de instâncias de máquinas virtuais.

Tipo:	Int32
Aliases:	VMInstancesCount
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Compartilhar via