Поделиться через


Rename-AzContext

Переименуйте контекст Azure. По умолчанию контексты именуются учетной записью пользователя и подпиской.

Синтаксис

Rename-AzContext
      -InputObject <PSAzureContext>
      [-Force]
      [-PassThru]
      [-Scope <ContextModificationScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-TargetName] <String>
      [<CommonParameters>]
Rename-AzContext
      [-Force]
      [-PassThru]
      [-Scope <ContextModificationScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-SourceName] <String>
      [-TargetName] <String>
      [<CommonParameters>]

Описание

Переименуйте контекст Azure. По умолчанию контексты именуются учетной записью пользователя и подпиской.

Примеры

Пример 1. Переименование контекста с помощью именованных параметров

Rename-AzContext -SourceName "[user1@contoso.org; 12345-6789-2345-3567890]" -TargetName "Work"

Переименуйте контекст для "user1@contoso.org" с подпиской "12345-6789-2345-3567890" в "Work". После выполнения этой команды вы сможете нацелиться на контекст с помощью Select-AzContext Work. Обратите внимание, что можно переходить по значениям "SourceName" с помощью завершения вкладки.

Пример 2. Переименование контекста с помощью позиционных параметров

Rename-AzContext "My context" "Work"

Переименуйте контекст с именем "Мой контекст" в "Work". После выполнения этой команды вы сможете настроить контекст с помощью Select-AzContext Work

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Учетные данные, клиент и подписка, используемые для обмена данными с Azure

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Переименуйте контекст, даже если целевой контекст уже существует

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Объект контекста, обычно передаваемый через конвейер.

Тип:PSAzureContext
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Возвращает переименованный контекст.

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Определяет область изменений контекста, например, применяются ли изменения только к текущему процессу или ко всем сеансам, запущенным этим пользователем.

Тип:ContextModificationScope
допустимые значения:Process, CurrentUser
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceName

Имя контекста

Тип:String
Position:0
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetName

Новое имя контекста

Тип:String
Position:1
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

PSAzureContext

Выходные данные

PSAzureContext