<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/python/framework/ops.py#L4445-L4481) |

Specifies the device for ops created/executed in this context.

    tf.device(
        device_name
    ) -> ContextManager[None]

### Used in the notebooks

| Used in the guide | Used in the tutorials |
|---|---|
| - [NumPy API on TensorFlow](https://www.tensorflow.org/guide/tf_numpy) - [Use a GPU](https://www.tensorflow.org/guide/gpu) - [Introduction to Variables](https://www.tensorflow.org/guide/variable) - [Random number generation](https://www.tensorflow.org/guide/random_numbers) - [Use TPUs](https://www.tensorflow.org/guide/tpu) | - [Customization basics: tensors and operations](https://www.tensorflow.org/tutorials/customization/basics) - [Solve GLUE tasks using BERT on TPU](https://www.tensorflow.org/text/tutorials/bert_glue) |

This function specifies the device to be used for ops created/executed in a
particular context. Nested contexts will inherit and also create/execute
their ops on the specified device. If a specific device is not required,
consider not using this function so that a device can be automatically
assigned. In general the use of this function is optional. `device_name` can
be fully specified, as in "/job:worker/task:1/device:cpu:0", or partially
specified, containing only a subset of the "/"-separated fields. Any fields
which are specified will override device annotations from outer scopes.

#### For example:

    with tf.device('/job:foo'):
      # ops created here have devices with /job:foo
      with tf.device('/job:bar/task:0/device:gpu:2'):
        # ops created here have the fully specified device above
      with tf.device('/device:gpu:1'):
        # ops created here have the device '/job:foo/device:gpu:1'

<br />

<br />

<br />

| ## Args ||
|---|---|
| `device_name` | The device name to use in the context. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A context manager that specifies the default device to use for newly created ops. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `RuntimeError` | If a function is passed in. |

<br />