Compartilhar via


New-AzGalleryInVMAccessControlProfileVersionConfig

Cria um objeto PSGalleryInVmAccessControlProfileVersion local.

Sintaxe

Default (Default)

New-AzGalleryInVMAccessControlProfileVersionConfig
    -Name <String>
    -Location <String>
    -Mode <String>
    -DefaultAccess <String>
    -TargetLocation <String[]>
    [-ExcludeFromLatest]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet New-AzGalleryInVMAccessControlProfileVersionConfig cria um objeto PSGalleryInVmAccessControlProfileVersion local, que pode ser usado com o cmdlet New-AzGalleryInVMAccessControlProfileVersion para criar uma nova Versão do Perfil de Controle de Acesso da VM no Azure.
Add-AzGalleryInVMAccessControlVersionRulesIdentity, Os cmdlets Add-AzGalleryInVMAccessControlVersionRulesPrivilege, Add-AzGalleryInVMAccessControlVersionRulesRole e Add-AzGalleryInVMAccessControlVersionRulesRoleAssignment podem ser usados para adicionar regras ao objeto PSGalleryInVmAccessControlProfileVersion.

Exemplos

Exemplo 1

New-AzGalleryInVMAccessControlProfileVersionConfig -Name "myProfileVersion" -Location "West US 2" -Mode "Audit" -DefaultAccess "Deny" -TargetLocation @("West US", "West US 2") -ExcludeFromLatest

Cria um objeto PSGalleryInVmAccessControlProfileVersion local com os parâmetros especificados.

Exemplo 2

$CPVersionConfig = New-AzGalleryInVMAccessControlProfileVersionConfig -Name "myProfileVersion" -Location "West US 2" -Mode "Audit" -DefaultAccess "Deny" -TargetLocation @("West US", "West US 2") `
| Add-AzGalleryInVMAccessControlProfileVersionRulesPrivilege -PrivilegeName "GoalState" -Path "/machine" -QueryParameter @{ comp = "goalstate" } `
| Add-AzGalleryInVMAccessControlProfileVersionRulesRole -RoleName "Provisioning" -Privilege @("GoalState") `
| Add-AzGalleryInVMAccessControlProfileVersionRulesIdentity -IdentityName "WinPA" -UserName "SYSTEM" -GroupName "Administrators" -ExePath "C:\Windows\System32\cscript.exe" -ProcessName "cscript" `
| Add-AzGalleryInVMAccessControlProfileVersionRulesRoleAssignment -Role "Provisioning" -Identity @("WinPA")

Cria um objeto PSGalleryInVmAccessControlProfileVersion local e, em seguida, adiciona regras.

Parâmetros

-DefaultAccess

Essa propriedade permite que você especifique se as solicitações terão permissão para acessar os pontos de extremidade do host.

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:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o 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

-ExcludeFromLatest

Se definido como true, as Máquinas Virtuais implantadas a partir da versão mais recente do Perfil de Recurso não usarão essa versão de Perfil.

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

-Location

O local da Galeria na versão do perfil de controle de acesso da VM.

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:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Mode

Essa propriedade permite que você especifique se as regras de controle de acesso estão no modo de auditoria, no modo Impor ou Desabilitado.

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:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

O nome da Versão do Perfil de Controle de Acesso da Galeria na VM.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-TargetLocation

Os nomes das regiões de destino para as quais a versão do Perfil de Recurso será replicada. Essa propriedade é atualizável.

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:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
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.

Entradas

String

String

SwitchParameter

Saídas

PSGalleryInVMAccessControlProfileVersion