zac para Macintosh (1)

Name

zac - A interface de gerenciamento de linha de comando do Agente do Micro Focus ZENworks que está instalado e em execução nos dispositivos gerenciados pelo Macintosh.

Sintaxe

zac command options

Descrição

O utilitário zac executa funções de gerenciamento de linha de comando no dispositivo gerenciado ZENworks, incluindo a instalação e remoção de bundles de software, aplicação de políticas e registro e cancelamento de registro do dispositivo.

Guia de utilização

Esta seção contém um guia para as convenções e a formatação gerais de comandos.

A maioria dos comandos tem uma forma extensa e uma forma abreviada:

  • Forma extensa: add-reg-key
  • Forma abreviada: ark

Quando ambos os formatos estão disponíveis, o comando é listado da seguinte forma:

add-reg-key (ark) opções

Ao usar o comando, insira apenas a forma por extenso ou a forma abreviada:

zac add-reg-key opções

zac ark opções

Se uma opção incluir um espaço, coloque-a entre aspas:

zac ark "opção 1"

Argumentos obrigatórios e opcionais

Os argumentos delimitados por parênteses ( ) são obrigatórios, e os delimitados por colchetes [ ] são opcionais.

Reticências (...)

As reticências indicam que um comando aceita várias entradas do último tipo de argumento. Os argumentos devem ser separados por espaço ou vírgulas, dependendo do comando. Por exemplo:

zman server-add-bundle [opções] (servidor) (bundle) [...]

As reticências indicam que server-add-bundle pode aceitar vários bundles. Na ajuda no nível do comando, o argumento de várias entradas é indicado como [(bundle) (bundle) ... (bundle)] para ficar mais claro.

Comandos de bundles

bundle-install (bin)

Instala os bundles determinados com base no nome de exibição que corresponde à expressão regular ou string especificada, ou ao GUID do bundle.

Use o comando bundle-list para obter uma lista dos bundles disponíveis e seus nomes de exibição.

Exemplo de como instalar um bundle:

zac bin MacBundle

bundle-launch (bln)

Inicia o bundle especificado. As ações no conjunto de Ações de Inicialização são executadas. Se você tentar iniciar um bundle que não esteja instalado, o bundle primeiro será instalado e depois iniciado.

Use o comando bundle-list para obter uma lista dos bundles disponíveis e seus nomes de exibição.

Um exemplo para iniciar um bundle com base no nome de exibição:

zac bln MacBundle

bundle-list (bl)

Exibe a lista de bundles atribuídos ao dispositivo e ao usuário conectado.

O resultado desse comando aparece nas colunas e mostram os detalhes de cada bundle atribuído ou disponível ao dispositivo gerenciado. As colunas Nome de Exibição, Versão e Tipo de Bundle representam o nome de exibição, o número da versão ou a área de segurança do bundle (se for da versão de área de segurança) e o tipo de bundle, respectivamente.

A coluna Status exibe os seguintes estados:

Disponível: exibe esse estado quando o bundle está instalado.

Não Instalado: exibe esse estado quando determinada versão do bundle não está instalada.

Descarregado: exibe esse estado quando o conteúdo foi descarregado, mas a ação no conjunto de Ações de Instalação não foi executada.

Veja um exemplo para listar todos os bundles:

zac bl

bundle-lock-add (bla) [opções] [nome do bundle] [...]

Bloqueia os bundles determinados que correspondem à expressão regular ou string especificada contra upgrade ou remoção.

Os bloqueios de bundle aplicam-se apenas ao conjunto de ações de Instalação.

Aceita as seguintes opções:

-li, --lock-install – Bloqueia o bundle e impede a instalação do bundle especificado no bloqueio.

-t, --type – Especifique o tipo de bundle a ser bloqueado. Os tipos disponíveis são MAC e Patch. Se nenhum tipo for especificado, o tipo bundle será selecionado.

bundle-lock-list (bll)

Lista os bloqueios de bundle. Os bloqueios de bundle são classificados pelo número de ID.

Exemplo de como listar os bundles bloqueados:

zac bll

bundle-lock-remove (blr)

Remove o bloqueio do bundle especificado por seu número. Você encontra o número de cada bloqueio usando o comando bundle-lock-list.

Um exemplo para remover todos os bloqueios de bundle:

zac blr --remove-all

bundle-props (bp)

Retorna as informações de propriedade de um bundle.

Exemplo de como obter as propriedades de determinado bundle:

zac bp MacBundle

bundle-refresh (br)

Atualiza as informações sobre o bundle especificado.

Exemplo de como atualizar um bundle:

zac br MacBundle

bundle-search (bse)

Pesquisa por bundles que correspondam à string ou expressão regular java especificada.

bundle-uninstall (bu)

Desinstala o bundle especificado. As ações que suportam a ação Desfazer são executadas na desinstalação do bundle. Após o término da desinstalação do bundle, o estado do bundle aparece como Não Instalado.

Use o comando bundle-list para obter uma lista dos bundles instalados e seus nomes de exibição.

Exemplo de como desinstalar um bundle:

zac bu MacBundle

bundle-verify (bv)

Reinstala o bundle e executa os conjuntos de ações Verificar para garantir que nenhum arquivo tenha sido removido ou corrompido. Use o comando bundle-list para obter uma lista dos bundles instalados e seus nomes de exibição.

Exemplo de como verificar um bundle:

zac bv MacBundle

Comandos básicos

add-reg-key (ark)

Esse comando registra um dispositivo usando a chave de registro especificada.

Exemplo: zac add-reg-key

agent-properties (agp)

Esse comando mostra informações sobre o Agente do ZENworks.

Exemplo: zac agent-properties

cache-clear (cc)

Limpa o cache do dispositivo.

Exemplo: zac cc

cert-info (ci)

Lista as informações do certificado da chave pública de cada servidor ZCM conhecido e adiciona um certificado raiz confiável ao armazenamento da máquina.

Exemplo:

Para listar o certificado de cada usuário conhecido do ZENworks:

zac ci

Para adicionar um certificado raiz confiável ao armazenamento confiável de dispositivos:

zac ci <local> -u meu_usuário -p minha_senha

config-location (cl)

Exibe o local atual.

Exemplo:

zac config-location

file-system-guid (fsg)

Remove e restaura o GUID de estação de trabalho no sistema de arquivos como preparação para obter uma imagem.

Exemplo:

Para exibir o valor de GUID:

zac fsg

Para remover o GUID e também o conninfo.dat do sistema de arquivos:

zac file-system-guid -d

Para restaurar o GUID no sistema de arquivos:

zac file-system-guid -r

Não especifique uma opção para imprimir o valor de GUID:

zac fsg

get-pref (get)

Exibe as preferências definidas.

Exemplo para exibir todas as preferências que tenham nomes começando com abc:

zac get-pref abc

get-settings (gs)

O download das configurações é feito pelo Módulo de Configurações para o cache local a cada atualização. Esse procedimento retornará as configurações efetivas associadas à chave especificada.

Exemplo:

zac gs key1

Você também pode usar o comando get-settings (gs) para listar as configurações usando várias chaves. Para obter mais informações, consulte get-settings (gs) <chave> na seção Comandos de status.

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] |managedlevel]

Muda a configuração do registrador.

Você pode usar as seguintes opções:

  • resetlog – Redefine o registro.
  • nível – Se usado sem um nível, exibe o nível de registro atual gerenciado. Se usado com um dos níveis, altera o nível de registro para o nível especificado.
  • managedlevel – Exibe o nível de Registro Global da zona.

Exemplo para redefinir o arquivo de registro:

zac logger resetlog

Exemplo para mostrar o nível de registro atual:

zac logger level

Exemplo para definir o nível de registro para DEBUG e acima:

zac logger level DEBUG

reestablish-trust (retr)

Esse comando restabelece a confiança com a zona atual.

Restabelece a confiança com a Zona de Gerenciamento atual. O nome de usuário e senha usados devem ser do Administrador da Zona.

Exemplo:

zac retr -u meu_usuário -p minha_senha

Os parâmetros -u e -p são opcionais. Se não usar os parâmetros -u e -p, você será solicitado a digitar um nome de usuário e uma senha.

refresh (ref)[general | partial bundle <Nome de Exibição do Bundle> [bypasscache]

Inicia uma atualização geral para todas as definições de bundles, políticas, registro e configuração; inicia uma atualização parcial para todas as definições de políticas, registro e configuração.

Use bypasscache para evitar o uso de dados do cache do servidor durante a atualização. Essa opção é útil para testes ou solução de problemas.

Exemplos:

zac ref general bypasscache

zac ref partial bypasscache

register (reg)

Esse comando registra um dispositivo em determinada zona.

Para executar esse comando, você deve ter direitos para Criar/Apagar dispositivos na pasta em que você está tentando registrar.

Exemplo:

zac reg -k key1 https://123.456.78.90

reregister (rereg)

Esse comando registra um dispositivo na zona atual e o atribui ao GUID de um objeto Dispositivo existente. O objeto Dispositivo associado no momento é apagado. Para executar esse comando, você deve ter direitos para Criar/Apagar dispositivos na pasta em que você está tentando registrar novamente.

Para registrar novamente, especifique um nome de usuário e uma senha:

zac reregister -u meu_usuário -p minha_senha eaa6a76814d650439c648d597280d5d4

set-pref (set)

Define o valor de uma preferência.

Exemplo para definir o valor de preferência abc como 123:

zac set-pref abc 123

set-proxy (sp) [opções] <endereço IP/Nome de host:porta>

Especifica um proxy para contato em vez de contatar um Servidor ZENworks diretamente.

As opções são:

  • --default – Define um proxy que pode ser anulado por configurações de proxy da Zona de Gerenciamento.
  • --clear – Limpa o proxy atual, mas usará as configurações de proxy da Zona de Gerenciamento.
  • --ipv6 – Define um proxy IPv6.

Exemplos:

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

IPv6:

zac sp /ipv6 [2001:db8:0:1:1:1:1:1]:2349 administrator novell

Se não for especificado um nome de usuário e uma senha, você será solicitado a digitá-los.

unregister (unr)

Esse comando cancela o registro de um dispositivo da zona atual.

Para executar esse comando, você deve ter direitos para Criar/Apagar dispositivos na pasta em que você está tentando cancelar o registro

Exemplo:

zac unr -u administrator -p novell

NOTA:A execução do comando UNR pode provocar alta utilização do banco de dados. Isso pode ocorrer por qualquer um dos seguintes motivos:

  • O comando UNR está em execução no servidor.

  • A zona contém um grande número de dispositivos gerenciados.

  • Os dispositivos gerenciados têm um histórico enorme.

  • O Gerenciamento de Patch está habilitado.

zone-config (zc)

Esse comando exibe o servidor de Configuração de Zona ou lista a configuração da zona atual.

zac zc

Comandos de inventário

inventory (inv) [scannow]

Executa a verificação de um inventário.

Exemplo de como executar a verificação de um inventário:

zac inv scannow

Comandos apenas inventário

Esses comandos só são usados para agentes Apenas Inventário (IOA, Inventory-Only Agents).

zac ioa cfg <IP do servidor>

Configura o dispositivo MAC IOA como o IP do servidor mencionado.

Um exemplo para registrar um dispositivo MAC Apenas Inventário no servidor <10.70.13.124>

zac ioa cfg 10.70.13.124

zac ioa version

Exibe a versão do agente Apenas Inventário (IOA).

inventory (inv) [scannow]

Executa a verificação de um inventário.

Exemplo de como executar a verificação de um inventário:

zac inv scannow

Comandos para gerenciamento de patches

patch-scan (ps)

Verifica o dispositivo para verificar se há patches não aplicados, usando o arquivo de assinatura do patch atual (DAU) do dispositivo. Em seguida, é feito upload dos resultados no servidor.

Exemplo de como executar uma verificação de patch:

zac ps

patch-scan --quick (ps --quick)

Faz upload dos resultados da última verificação para o servidor. Esse comando não executa uma nova verificação de detecção.

Exemplo de como executar uma verificação rápida de patch:

zac ps --quick

patch-scan --complete (ps --complete)

Verifica o dispositivo para verificar se há patches não aplicados, usando um arquivo de assinatura do patch atualizado (DAU). Em seguida, é feito upload dos resultados no servidor.

Exemplo de como executar uma verificação completa de patch:

zac ps --complete

patch-apply-policy (pap)

Atualiza os dispositivos com a versão mais recente de todas as políticas de patch.

Exemplo de como executar uma política de aplicação de patch:

zac pap

patch-quarantine-release (pqr)

Libera da quarentena todos os patches em quarentena no dispositivo em que o comando é executado, de modo que uma única tentativa de instalação possa ser realizada, seja de uma programação de política de patch ou de uma programação de correção.

Exemplo de como executar uma liberação de quarentena de patch:

zac pq

Comandos de funções Satélite

satellite-cachecfg (satcfg)

Lê funções do Satélite do cache.

Exemplo de como ler funções Satélite no cache:

zac satcfg

satellite-clearcache (satcc)

Remove informações de configuração do Satélite do cache.

Exemplo de como limpar as informações de configuração de Satélite do cache:

zac satcc

satellite-refreshcfg (satrc)

Atualiza funções do Satélite.

Exemplo de como atualizar funções Satélite:

zac satrc

satellite-roles (satr)

Informa sobre as funções atuais do Satélite e seus estados.

Exemplo de como relatar as funções Satélite atuais e seu estado:

zac satr

Comandos de status

zenhttp-status(zhs)

Lista a porta e as tags das sub-rotinas registradas.

Exemplo de como listar portas e tags de gerenciadores registrados:

zac zhs

Esse comando aplica-se apenas quando o agente é promovido como um satélite.

Comandos de atualização do sistema

zac zeus-refresh / zeus-ref

Recupera a atualização do sistema quando ela é atribuída a um dispositivo.

Comandos de certificado do ZENworks

zac certificate-verify / cv

Verifica se a certificação do servidor e o arquivo de chave copiado para o repositório de recriação são válidos e atualiza os resultados para o servidor.