NAME
    gcloud compute os-config policy-orchestrators update - update a policy
        orchestrator

SYNOPSIS
    gcloud compute os-config policy-orchestrators update
        (POLICY_ORCHESTRATOR : --folder=FOLDER --organization=ORGANIZATION)
        [--action=ACTION] [--async] [--policy-file=POLICY_FILE]
        [--policy-id=POLICY_ID] [--state=STATE]
        [--clear-folders | --include-folders=INCLUDE_FOLDERS]
        [--clear-locations | --include-locations=INCLUDE_LOCATIONS]
        [--clear-projects | --include-projects=INCLUDE_PROJECTS]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Update a policy orchestrator.

EXAMPLES
    To update an policy orchestrator my-orchestrator in folder 123456 with
    config file /path/to/file/config.yaml, run:

        $ gcloud compute os-config policy-orchestrators update \
            my-orchestrator --folder=123456 \
            --policy-file=/path/to/file/config.yaml

    To update an policy orchestrator my-orchestrator in folder 123456 with
    state STOPPED, run:

        $ gcloud compute os-config policy-orchestrators update \
            my-orchestrator --folder=123456 --state=stopped

POSITIONAL ARGUMENTS
     Policy orchestrator resource - Policy orchestrator to update. The
     arguments in this group can be used to specify the attributes of this
     resource. (NOTE) Some attributes are not given arguments in this group but
     can be set in other ways.

     To set the project attribute:
      ◆ provide the argument policy_orchestrator on the command line with a
        fully specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project. This resource can be one of the
        following types: [policy_orchestrator_project,
        policy_orchestrator_folder, policy_orchestrator_organization].

     This must be specified.

       POLICY_ORCHESTRATOR
          ID of the policy_orchestrator or fully qualified identifier for the
          policy_orchestrator.

          To set the policy_orchestrator attribute:
          ▸ provide the argument policy_orchestrator on the command line.

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --folder=FOLDER
          Folder of the policy_orchestrator.

          To set the folder attribute:
          ▸ provide the argument policy_orchestrator on the command line with
            a fully specified name;
          ▸ provide the argument --folder on the command line. Must be
            specified for resource of type [policy_orchestrator_folder].

       --organization=ORGANIZATION
          Organization of the policy_orchestrator.

          To set the organization attribute:
          ▸ provide the argument policy_orchestrator on the command line with
            a fully specified name;
          ▸ provide the argument --organization on the command line. Must be
            specified for resource of type [policy_orchestrator_organization].

FLAGS
     --action=ACTION
        Action to be taken on policy. ACTION must be one of:

         delete
            Delete a policy with a given name. policy-id must be specified.
         upsert
            Create or update a policy. policy-file must be specified.

     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --policy-file=POLICY_FILE
        Absolute path to the OS policy assignment file on your local client.
        File must be in either JSON or YAML format. This file defines the OS
        policies that you want to apply to your VMs, the target VMs that you
        want to apply the policies to, and the rollout rate at which to apply
        the OS policies on a zonal level. For more information about this
        resource and sample OS policy assignment files, see
        https://cloud.google.com/compute/docs/os-configuration-management/working-with-os-policies#os-policy-assignment.

     --policy-id=POLICY_ID
        Policy id. Must be specified for DELETE action.

     --state=STATE
        State of the policy orchestrator. STATE must be one of:

         active
            Updates the policy orchestrator to ACTIVE state.
         stopped
            Updates the policy orchestrator to STOPPED state.

     Folders to include in the policy orchestrator. Comma-separated list of
     folder numbers. If --include-folders is set, --clear-folders must not be
     set.

     At most one of these can be specified:

       --clear-folders
          Clears included folders from policy orchestrator selectors.

       --include-folders=INCLUDE_FOLDERS
          Applies policy to selected folders only.

     Locations to include in the policy orchestrator, e.g. us-central1-a. If
     include-locations is set, clear-locations must not be set.

     At most one of these can be specified:

       --clear-locations
          Clears included locations from policy orchestrator selectors.

       --include-locations=INCLUDE_LOCATIONS
          Applies policy to selected locations only.

     Projects to include in the policy orchestrator. Comma separated list of
     project numbers. If include-projects is set, clear-projects must not be
     set.

     At most one of these can be specified:

       --clear-projects
          Clears included projects from policy orchestrator selectors.

       --include-projects=INCLUDE_PROJECTS
          Applies policy to selected projects only.

GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
    --help, --impersonate-service-account, --log-http, --project, --quiet,
    --trace-token, --user-output-enabled, --verbosity.

    Run $ gcloud help for details.

API REFERENCE
    This command uses the osconfig/v2 API. The full documentation for this API
    can be found at: https://cloud.google.com/compute/docs/osconfig/rest

NOTES
    These variants are also available:

        $ gcloud alpha compute os-config policy-orchestrators update

        $ gcloud beta compute os-config policy-orchestrators update

