Update-AzGallery

Módulo:: Az.Compute Module

Atualize uma galeria.

Sintaxe

DefaultParameter (Default)

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>]

Description

Atualize uma galeria.

Exemplos

Exemplo 1

Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -Description $galleryDescription

Atualize uma galeria.

Exemplo 2

Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -Permission Groups -Share -Tenant xxxxxxxx-xxx-xxxxxxx,zzzzzz-zzzzzzz-zzzzzz

Atualize uma galeria para ser compartilhada e adicione duas assinaturas com as qual ela deve ser compartilhada.

Exemplo 3

Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -EnableSystemAssignedIdentity

Atualize uma galeria para habilitar uma identidade gerenciada atribuída pelo sistema.

Exemplo 4

$uid = Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $identityName
Get-AzGallery -ResourceGroupName $rgname -Name $galleryName | Update-AzGallery -UserAssignedIdentity $uid.Id

Atualize uma galeria para adicionar uma identidade gerenciada atribuída pelo usuário usando a entrada do pipeline.

Exemplo 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)

Atualize uma galeria para adicionar as duas identidades gerenciadas atribuídas pelo usuário especificadas. Elas são acrescentadas a identidades atribuídas anteriormente.

Exemplo 6

Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -DisableSystemAssignedIdentity

Atualize uma galeria para desabilitar sua identidade gerenciada atribuída pelo sistema.

Exemplo 7

Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -RemoveUserAssignedIdentity "All"

Atualize uma galeria para remover todas as identidades gerenciadas atribuídas pelo usuário.

Exemplo 8

$uid = (Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $identityName).Id
Update-AzGallery -ResourceGroupName $rgname -Name $galleryName -RemoveUserAssignedIdentity @($uid)

Atualize uma galeria para remover uma identidade gerenciada atribuída pelo usuário específica.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Community

Atualize o perfil de compartilhamento da galeria para a comunidade.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com Azure.

Propriedades do parâmetro

Tipo:	IAzureContextContainer
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Description

A descrição do recurso da galeria.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-DisableSystemAssignedIdentity

Desabilita a identidade gerenciada atribuída pelo sistema na galeria. Não é possível usar junto com -EnableSystemAssignedIdentity.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableSystemAssignedIdentity

Habilita a identidade gerenciada atribuída pelo sistema na galeria. Não é possível usar junto com -DisableSystemAssignedIdentity.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Eula

Obtém ou define o contrato de licença do usuário final para a imagem da galeria da comunidade.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-InputObject

O objeto da galeria PS.

Propriedades do parâmetro

Tipo:	PSGallery
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	Gallery

Conjuntos de parâmetros

ObjectParameter

Cargo:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Name

O nome da galeria.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	GalleryName

Conjuntos de parâmetros

DefaultParameter

Cargo:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Permission

Essa propriedade permite que você especifique a permissão da galeria de compartilhamento. Os valores possíveis são: 'Privado' e 'Grupos'.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-PublicNamePrefix

Obtém ou define o prefixo do nome da galeria que será exibido publicamente. Visível para todos os usuários.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-PublisherContact

Obtém ou define o email de suporte do editor da galeria da comunidade. O endereço de email do editor. Visível para todos os usuários.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-PublisherUri

Obtém ou define o link para o site do editor. Visível para todos os usuários.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-RemoveSubscription

Uma lista de IDs de assinatura à qual a galeria deixará de compartilhar.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-RemoveTenant

Uma lista de IDs de locatário à qual a galeria interromperá o compartilhamento.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-RemoveUserAssignedIdentity

A lista de IDs de recurso de identidade gerenciada atribuídas pelo usuário a serem removidas da galeria. Como alternativa, especifique "Todos" para remover todas as identidades atribuídas pelo usuário. Se 'All' for fornecido, ele deverá ser o único valor em -RemoveUserAssignedIdentity e qualquer uso de 'All' faz com que todas as identidades atribuídas pelo usuário sejam removidas. Não é possível usar 'All' junto com -UserAssignedIdentity.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Reset

Redefine a permissão de compartilhamento da galeria para 'Private'.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-ResourceGroupName

O nome do grupo de recursos.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

DefaultParameter

Cargo:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-ResourceId

A ID do recurso para a galeria

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ResourceIdParameter

Cargo:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

Atualizar o perfil de compartilhamento da galeria.

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Subscription

Uma lista de IDs de assinatura à qual a galeria deve ser compartilhada.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Tag

Etiquetas de recursos

Propriedades do parâmetro

Tipo:	Hashtable
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Tenant

Uma lista de IDs de locatário à qual a galeria deve ser compartilhada.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-UserAssignedIdentity

A lista de IDs de recurso de identidade gerenciada atribuídas pelo usuário a serem adicionadas à galeria. As identidades são acrescentadas a todas as identidades atribuídas pelo usuário existentes. Não é possível usar junto com '-RemoveUserAssignedIdentity All'. As IDs de recurso estão no formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}'.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

PSGallery

Comentários

Esta página foi útil?