Update-AzGallery
Синтаксис
DefaultParameter (По умолчанию)
Update-AzGallery
[-ResourceGroupName] <String>
[-Name] <String>
[-AsJob]
[-Description <String>]
[-Tag <Hashtable>]
[-Permission <String>]
[-Subscription <String[]>]
[-Tenant <String[]>]
[-RemoveSubscription <String[]>]
[-RemoveTenant <String[]>]
[-Share]
[-Community]
[-Reset]
[-PublisherUri <String>]
[-PublisherContact <String>]
[-Eula <String>]
[-PublicNamePrefix <String>]
[-EnableSystemAssignedIdentity]
[-DisableSystemAssignedIdentity]
[-UserAssignedIdentity <String[]>]
[-RemoveUserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdParameter
Update-AzGallery
[-ResourceId] <String>
[-AsJob]
[-Description <String>]
[-Tag <Hashtable>]
[-Permission <String>]
[-Subscription <String[]>]
[-Tenant <String[]>]
[-RemoveSubscription <String[]>]
[-RemoveTenant <String[]>]
[-Share]
[-Community]
[-Reset]
[-PublisherUri <String>]
[-PublisherContact <String>]
[-Eula <String>]
[-PublicNamePrefix <String>]
[-EnableSystemAssignedIdentity]
[-DisableSystemAssignedIdentity]
[-UserAssignedIdentity <String[]>]
[-RemoveUserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ObjectParameter
Update-AzGallery
[-InputObject] <PSGallery>
[-AsJob]
[-Description <String>]
[-Tag <Hashtable>]
[-Permission <String>]
[-Subscription <String[]>]
[-Tenant <String[]>]
[-RemoveSubscription <String[]>]
[-RemoveTenant <String[]>]
[-Share]
[-Community]
[-Reset]
[-PublisherUri <String>]
[-PublisherContact <String>]
[-Eula <String>]
[-PublicNamePrefix <String>]
[-EnableSystemAssignedIdentity]
[-DisableSystemAssignedIdentity]
[-UserAssignedIdentity <String[]>]
[-RemoveUserAssignedIdentity <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Примеры
Пример 1
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -Description $galleryDescription
Обновление коллекции.
Пример 2
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -Permission Groups -Share -Tenant xxxxxxxx-xxx-xxxxxxx,zzzzzz-zzzzzzz-zzzzzz
Обновите коллекцию для общего доступа и добавьте две подписки, с которыми он должен быть предоставлен.
Пример 3
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -EnableSystemAssignedIdentity
Обновите коллекцию, чтобы включить управляемое удостоверение, назначаемое системой.
Пример 4
$uid = Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $identityName
Get-AzGallery -ResourceGroupName $rgname -Name $galleryName | Update-AzGallery -UserAssignedIdentity $uid.Id
Обновите коллекцию, чтобы добавить управляемое удостоверение, назначаемое пользователем, с помощью входных данных конвейера.
Пример 5
$uid1 = (Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $identityName1).Id
$uid2 = (Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $identityName2).Id
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -UserAssignedIdentity @($uid1, $uid2)
Обновите коллекцию, чтобы добавить два указанных управляемых удостоверения, назначаемых пользователем. Они добавляются к любым ранее назначенным удостоверениям.
Пример 6
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -DisableSystemAssignedIdentity
Обновите коллекцию, чтобы отключить управляемое удостоверение, назначаемое системой.
Пример 7
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -RemoveUserAssignedIdentity "All"
Обновите коллекцию, чтобы удалить все управляемые удостоверения, назначаемые пользователем.
Пример 8
$uid = (Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $identityName).Id
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -RemoveUserAssignedIdentity @($uid)
Обновите коллекцию, чтобы удалить определенное управляемое удостоверение, назначаемое пользователем.
Параметры
-AsJob
Запуск командлета в фоновом режиме
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
Обновите профиль общего доступа к коллекции для сообщества.
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Cf
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
Тип: IAzureContextContainer
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Description
Описание ресурса коллекции.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-DisableSystemAssignedIdentity
Отключает управляемое удостоверение, назначаемое системой, в коллекции. Нельзя использовать вместе с -EnableSystemAssignedIdentity.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-EnableSystemAssignedIdentity
Включает управляемое удостоверение, назначаемое системой, в коллекции. Нельзя использовать вместе с -DisableSystemAssignedIdentity.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Eula
Возвращает или задает лицензионное соглашение конечного пользователя для образа коллекции сообщества.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
Объект коллекции PS.
Тип: PSGallery
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Gallery
ObjectParameter
Position: 0
Обязательно: True
Значение из конвейера: True
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Name
Имя коллекции.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Имя коллекции
Наборы параметров
DefaultParameter
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Permission
Это свойство позволяет указать разрешение коллекции общего доступа. Возможные значения: Private и Groups.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-PublicNamePrefix
Возвращает или задает префикс имени коллекции, отображаемого публично. Видимый всем пользователям.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
Возвращает или задает адрес электронной почты издателя коллекции сообщества. Адрес электронной почты издателя. Видимый всем пользователям.
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-PublisherUri
Возвращает или задает ссылку на веб-сайт издателя. Видимый всем пользователям.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-RemoveSubscription
Список идентификаторов подписок, в которые коллекция перестанет предоставлять общий доступ.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-RemoveTenant
Список идентификаторов клиентов, в которые коллекция перестанет предоставлять общий доступ.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-RemoveUserAssignedIdentity
Список идентификаторов ресурсов управляемого удостоверения, назначаемых пользователем, которые необходимо удалить из коллекции. Кроме того, укажите "Все" для удаления всех удостоверений, назначенных пользователем. Если задано значение All, оно должно быть единственным значением в -RemoveUserAssignedIdentity, а любое использование "Все" приводит к удалению всех удостоверений, назначенных пользователем. Не удается использовать "All" вместе с -UserAssignedIdentity.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Reset
Сбрасывает разрешение на общий доступ коллекции на Private.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-ResourceGroupName
Имя группы ресурсов.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
DefaultParameter
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-ResourceId
Идентификатор ресурса для коллекции
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
ResourceIdParameter
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Share
Обновите профиль общего доступа коллекции.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Subscription
Список идентификаторов подписок, которыми является коллекция, предназначена для общего доступа.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Tag
Теги ресурсов
Свойства параметров
Тип: Hashtable
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-Tenant
Список идентификаторов клиентов, которыми является коллекция, направлена на общий доступ.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-UserAssignedIdentity
Список идентификаторов ресурсов управляемого удостоверения, назначаемых пользователем, добавляемых в коллекцию. Удостоверения добавляются к существующим удостоверениям, назначенным пользователем. Не удается использовать вместе с "-RemoveUserAssignedIdentity All". Идентификаторы ресурсов находятся в форме "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}'.
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-WhatIf
Показывает, что произойдет, если командлет будет запущен.
Командлет не запускается.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Wi
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные