az guestconfig guest-configuration-hcrp-assignment
Observação
Essa referência faz parte da extensão guestconfig para a CLI do Azure (versão 2.3.1 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az guestconfig guest-configuration-hcrp-assignment . Saiba mais sobre extensões.
Este grupo de comando é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Guestconfig guest-configuration-hcrp-assignment.
Comandos
Nome | Description | Tipo | Status |
---|---|---|---|
az guestconfig guest-configuration-hcrp-assignment create |
Cria uma associação entre uma máquina ARC e a configuração de convidado. |
Extensão | Habilitação |
az guestconfig guest-configuration-hcrp-assignment delete |
Exclua uma atribuição de configuração de convidado. |
Extensão | Habilitação |
az guestconfig guest-configuration-hcrp-assignment list |
Liste todas as atribuições de configuração de convidado para uma máquina ARC. |
Extensão | Habilitação |
az guestconfig guest-configuration-hcrp-assignment show |
Obtenha informações sobre uma atribuição de configuração de convidado. |
Extensão | Habilitação |
az guestconfig guest-configuration-hcrp-assignment update |
Cria uma associação entre uma máquina ARC e a configuração de convidado. |
Extensão | Habilitação |
az guestconfig guest-configuration-hcrp-assignment wait |
Coloque a CLI em um estado de espera até que uma condição do guestconfig guest-configuration-hcrp-assignment seja atendida. |
Extensão | Habilitação |
az guestconfig guest-configuration-hcrp-assignment create
O grupo de comandos 'guestconfig guest-configuration-hcrp-assignment' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Cria uma associação entre uma máquina ARC e a configuração de convidado.
az guestconfig guest-configuration-hcrp-assignment create --guest-configuration-assignment-name
--machine-name
--resource-group
[--context]
[--guest-configuration-configuration-parameter]
[--guest-configuration-configuration-setting]
[--guest-configuration-name]
[--guest-configuration-version]
[--latest-assignment-report-assignment]
[--location]
[--name]
[--no-wait]
Exemplos
Criar ou atualizar atribuição de configuração de convidado
az guestconfig guest-configuration-hcrp-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --machine-name "myMachineName" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName"
Parâmetros Exigidos
Nome da atribuição de configuração do convidado.
O nome da máquina ARC.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
A origem que iniciou a atribuição de configuração do convidado. Ex: Política do Azure.
Os parâmetros de configuração para a configuração do convidado.
Uso: --guest-configuration-configuration-parameter name=XX value=XX
name: Nome do parâmetro de configuração. value: Valor do parâmetro de configuração.
Várias ações podem ser especificadas usando mais de um argumento --guest-configuration-configuration-parameter.
A definição de configuração para a configuração do convidado.
Uso: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX
configuration-mode: especifica como o LCM (Local Configuration Manager) realmente aplica a configuração aos nós de destino. Os valores possíveis são ApplyOnly, ApplyAndMonitore ApplyAndAutoCorrect. allow-module-overwrite: Se true - novas configurações baixadas do serviço pull têm permissão para substituir as antigas no nó de destino. Caso contrário, false action-after-reboot: especifica o que acontece após uma reinicialização durante a aplicação de uma configuração. Os valores possíveis são ContinueConfiguration e StopConfiguration refresh-frequency-mins: o intervalo de tempo, em minutos, no qual o LCM verifica um serviço pull para obter configurações atualizadas. Esse valor será ignorado se o LCM não estiver configurado no modo de pull. O valor padrão é 30. reboot-if-needed: defina isso como true para reinicializar automaticamente o nó depois que uma configuração que requer reinicialização for aplicada. Caso contrário, você precisará reinicializar manualmente o nó para qualquer configuração que exigir. O valor padrão é false. Para usar essa configuração quando uma condição de reinicialização for representada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot. configuration-mode-frequency-mins: Com que frequência, em minutos, a configuração atual é verificada e aplicada. Essa propriedade será ignorada se a propriedade ConfigurationMode estiver definida como ApplyOnly. O valor padrão é 15.
Nome da configuração do convidado.
Versão da configuração do convidado.
Detalhes de configuração da atribuição de configuração de convidado. Valor esperado: json-string/@json-file.
Local. Valores de: az account list-locations
. Você pode configurar o local padrão usando az configure --defaults location=<location>
.
Nome da atribuição de configuração do convidado.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az guestconfig guest-configuration-hcrp-assignment delete
O grupo de comandos 'guestconfig guest-configuration-hcrp-assignment' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Exclua uma atribuição de configuração de convidado.
az guestconfig guest-configuration-hcrp-assignment delete [--guest-configuration-assignment-name]
[--ids]
[--machine-name]
[--no-wait]
[--resource-group]
[--subscription]
Exemplos
Excluir uma atribuição de configuração de convidado
az guestconfig guest-configuration-hcrp-assignment delete --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName"
Parâmetros Opcionais
Nome da atribuição de configuração do convidado.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome da máquina ARC.
Não aguarde a conclusão da operação de execução longa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az guestconfig guest-configuration-hcrp-assignment list
O grupo de comandos 'guestconfig guest-configuration-hcrp-assignment' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Liste todas as atribuições de configuração de convidado para uma máquina ARC.
az guestconfig guest-configuration-hcrp-assignment list --machine-name
--resource-group
Exemplos
Listar todas as atribuições de configuração de convidado para uma máquina virtual
az guestconfig guest-configuration-hcrp-assignment list --machine-name "myMachineName" --resource-group "myResourceGroupName"
Parâmetros Exigidos
O nome da máquina ARC.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az guestconfig guest-configuration-hcrp-assignment show
O grupo de comandos 'guestconfig guest-configuration-hcrp-assignment' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Obtenha informações sobre uma atribuição de configuração de convidado.
az guestconfig guest-configuration-hcrp-assignment show [--guest-configuration-assignment-name]
[--ids]
[--machine-name]
[--resource-group]
[--subscription]
Exemplos
Obter uma atribuição de configuração de convidado
az guestconfig guest-configuration-hcrp-assignment show --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName"
Parâmetros Opcionais
O nome da atribuição de configuração do convidado.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome da máquina ARC.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az guestconfig guest-configuration-hcrp-assignment update
O grupo de comandos 'guestconfig guest-configuration-hcrp-assignment' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Cria uma associação entre uma máquina ARC e a configuração de convidado.
az guestconfig guest-configuration-hcrp-assignment update [--context]
[--guest-configuration-assignment-name]
[--guest-configuration-configuration-parameter]
[--guest-configuration-configuration-setting]
[--guest-configuration-name]
[--guest-configuration-version]
[--ids]
[--latest-assignment-report-assignment]
[--location]
[--machine-name]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
Exemplos
Criar ou atualizar atribuição de configuração de convidado
az guestconfig guest-configuration-hcrp-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --machine-name "myMachineName" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName"
Parâmetros Opcionais
A origem que iniciou a atribuição de configuração do convidado. Ex: Política do Azure.
Nome da atribuição de configuração do convidado.
Os parâmetros de configuração para a configuração do convidado.
Uso: --guest-configuration-configuration-parameter name=XX value=XX
name: Nome do parâmetro de configuração. value: Valor do parâmetro de configuração.
Várias ações podem ser especificadas usando mais de um argumento --guest-configuration-configuration-parameter.
A definição de configuração para a configuração do convidado.
Uso: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX
configuration-mode: especifica como o LCM (Local Configuration Manager) realmente aplica a configuração aos nós de destino. Os valores possíveis são ApplyOnly, ApplyAndMonitore ApplyAndAutoCorrect. allow-module-overwrite: Se true - novas configurações baixadas do serviço pull têm permissão para substituir as antigas no nó de destino. Caso contrário, false action-after-reboot: especifica o que acontece após uma reinicialização durante a aplicação de uma configuração. Os valores possíveis são ContinueConfiguration e StopConfiguration refresh-frequency-mins: o intervalo de tempo, em minutos, no qual o LCM verifica um serviço pull para obter configurações atualizadas. Esse valor será ignorado se o LCM não estiver configurado no modo de pull. O valor padrão é 30. reboot-if-needed: defina isso como true para reinicializar automaticamente o nó depois que uma configuração que requer reinicialização for aplicada. Caso contrário, você precisará reinicializar manualmente o nó para qualquer configuração que exigir. O valor padrão é false. Para usar essa configuração quando uma condição de reinicialização for representada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot. configuration-mode-frequency-mins: Com que frequência, em minutos, a configuração atual é verificada e aplicada. Essa propriedade será ignorada se a propriedade ConfigurationMode estiver definida como ApplyOnly. O valor padrão é 15.
Nome da configuração do convidado.
Versão da configuração do convidado.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
Detalhes de configuração da atribuição de configuração de convidado. Valor esperado: json-string/@json-file.
Local. Valores de: az account list-locations
. Você pode configurar o local padrão usando az configure --defaults location=<location>
.
O nome da máquina ARC.
Nome da atribuição de configuração do convidado.
Não aguarde a conclusão da operação de execução longa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az guestconfig guest-configuration-hcrp-assignment wait
O grupo de comandos 'guestconfig guest-configuration-hcrp-assignment' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Coloque a CLI em um estado de espera até que uma condição do guestconfig guest-configuration-hcrp-assignment seja atendida.
az guestconfig guest-configuration-hcrp-assignment wait [--created]
[--custom]
[--deleted]
[--exists]
[--guest-configuration-assignment-name]
[--ids]
[--interval]
[--machine-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Exemplos
Pause a execução da próxima linha do script da CLI até que o guestconfig guest-configuration-hcrp-assignment seja criado com êxito.
az guestconfig guest-configuration-hcrp-assignment wait --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName" --created
Pause a execução da próxima linha do script da CLI até que o guestconfig guest-configuration-hcrp-assignment seja excluído com êxito.
az guestconfig guest-configuration-hcrp-assignment wait --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName" --deleted
Parâmetros Opcionais
Aguarde até criar com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Aguarde até ser excluído.
Aguarde até que o recurso exista.
O nome da atribuição de configuração do convidado.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
Intervalo de sondagem em segundos.
O nome da máquina ARC.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Espera máxima em segundos.
Aguarde até que seja atualizado com provisioningState em 'Succeeded'.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de