Get-AzureRmPolicyAlias
Get-AzureRmPolicyAlias recupera e gera tipos de recursos do provedor do Azure que têm aliases definidos e correspondem aos valores de parâmetro fornecidos. Se nenhum parâmetro for fornecido, todos os tipos de recursos do provedor que contêm um alias serão gerados. A opção -ListAvailable modifica esse comportamento listando todos os tipos de recursos correspondentes, incluindo aqueles sem aliases.
Aviso
O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Syntax
Get-AzureRmPolicyAlias
[-NamespaceMatch <String>]
[-ResourceTypeMatch <String>]
[-AliasMatch <String>]
[-PathMatch <String>]
[-ApiVersionMatch <String>]
[-LocationMatch <String>]
[-ListAvailable]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzureRmPolicyAlias obtém uma lista de aliases de política. Os aliases de política são usados pela Política do Azure para fazer referência a propriedades de tipo de recurso. São fornecidos parâmetros que limitam os itens na listagem combinando várias propriedades do tipo de recurso ou seus aliases. Um determinado valor de correspondência corresponde se a cadeia de caracteres de destino contiver usando comparação sem diferenciação de maiúsculas e minúsculas.
Exemplos
Exemplo 1
PS C:\> Get-AzureRmPolicyAlias
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.AnalysisServices servers {Microsoft.AnalysisServices/servers/state, Microsoft.AnalysisServices/s...
Microsoft.Authorization roleAssignments {Microsoft.Authorization/roleAssignments/roleDefinitionId, Microsoft.Au...
Microsoft.Authorization roleDefinitions {Microsoft.Authorization/roleDefinitions/type, Microsoft.Authorization/...
... ... ...
Microsoft.Web hostingEnvironments {Microsoft.Web/hostingEnvironments/clusterSettings[*].name, Microsoft.W...
Microsoft.Web sites/config {Microsoft.Web/sites/config/httpLoggingEnabled, Microsoft.Web/sites/con...
Microsoft.GuestConfiguration guestConfigurationAssignments {Microsoft.GuestConfiguration/guestConfigurationAssignments/complianceS...
PS C:\>
Lista todos os tipos de recursos de provedor que têm um alias.
Exemplo 2
PS C:\> Get-AzureRmPolicyAlias -ListAvailable
Namespace ResourceType Aliases
--------- ------------ -------
... ... ...
Microsoft.AlertsManagement operations {}
Microsoft.AnalysisServices servers {Microsoft.AnalysisServices/servers/sta...
Microsoft.AnalysisServices locations {}
... ... ...
PS C:\>
Lista todos os tipos de recursos do provedor, incluindo aqueles sem aliases.
Exemplo 3
PS C:\> Get-AzureRmPolicyAlias -NamespaceMatch 'compute'
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.Compute virtualMachines {Microsoft.Compute/licenseType, Microsoft.Compute/virtualMachines/availabilitySet.id, Microsoft...
Microsoft.Compute virtualMachines/extensions {Microsoft.Compute/virtualMachines/extensions/provisioningState, Microsoft.Compute/virtualMachi...
Microsoft.Compute virtualMachineScaleSets {Microsoft.Compute/VirtualMachineScaleSets/sku.name, Microsoft.Compute/VirtualMachineScaleSets/...
Microsoft.Compute virtualMachineScaleSets/extensions {Microsoft.Compute/virtualMachineScaleSets/extensions/provisioningState, Microsoft.Compute/virt...
Microsoft.Compute disks {Microsoft.Compute/imagePublisher, Microsoft.Compute/imageOffer, Microsoft.Compute/imageSku, Mi...
PS C:\>
Lista todos os tipos de recursos do provedor cujo namespace corresponde a 'compute' e contém um alias.
Exemplo 4
PS C:\> Get-AzureRmPolicyAlias -ResourceTypeMatch 'virtual'
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.Compute virtualMachines {Microsoft.Compute/licenseType, Microsoft.Compute/virtualMachines/availabilitySet.id, Micro...
Microsoft.Compute virtualMachines/extensions {Microsoft.Compute/virtualMachines/extensions/provisioningState, Microsoft.Compute/virtualM...
Microsoft.Compute virtualMachineScaleSets {Microsoft.Compute/VirtualMachineScaleSets/sku.name, Microsoft.Compute/VirtualMachineScaleS...
Microsoft.Compute virtualMachineScaleSets/extensions {Microsoft.Compute/virtualMachineScaleSets/extensions/provisioningState, Microsoft.Compute/...
Microsoft.Network virtualNetworks {Microsoft.Network/virtualNetworks/subnets[*].routeTable.id, Microsoft.Network/virtualNetwo...
Microsoft.Network virtualNetworkGateways {Microsoft.Network/virtualNetworkGateways/sku.name, Microsoft.Network/virtualNetworkGateway...
Microsoft.Network virtualNetworks/subnets {Microsoft.Network/virtualNetworks/subnets/routeTable.id, Microsoft.Network/virtualNetworks...
Microsoft.Network virtualNetworks/virtualNetworkPeerings {Microsoft.Network/virtualNetworks/virtualNetworkPeerings/remoteVirtualNetwork.id}
Microsoft.Sql servers/virtualNetworkRules {Microsoft.Sql/servers/virtualNetworkRules/virtualNetworkSubnetId, Microsoft.Sql/servers/vi...
PS C:\>
Lista todos os tipos de recursos de provedor cujo tipo de recurso corresponde a 'virtual' e contém um alias.
Exemplo 5
PS C:\> Get-AzureRmPolicyAlias -ResourceTypeMatch 'virtual' -ListAvailable
Namespace ResourceType Aliases
--------- ------------ -------
... ... ...
Microsoft.KeyVault locations/deleteVirtualNetworkOrSubnets {}
Microsoft.Network virtualNetworks {Microsoft.Network/virtualNetworks/subnets[*].routeTable.id,...
Microsoft.Network virtualNetworkGateways {Microsoft.Network/virtualNetworkGateways/sku.name, Microsof...
Microsoft.Network locations/virtualNetworkAvailableEndpointServices {}
... ... ...
PS C:\>
Lista todos os tipos de recursos do provedor cujo tipo de recurso corresponde a 'virtual', incluindo aqueles sem aliases.
Exemplo 6
PS C:\> Get-AzureRmPolicyAlias -NamespaceMatch 'compute' -ResourceTypeMatch 'virtual'
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.Compute virtualMachines {Microsoft.Compute/licenseType, Microsoft.Compute/virtualMachines/availabilitySet.id, Microsoft...
Microsoft.Compute virtualMachines/extensions {Microsoft.Compute/virtualMachines/extensions/provisioningState, Microsoft.Compute/virtualMachi...
Microsoft.Compute virtualMachineScaleSets {Microsoft.Compute/VirtualMachineScaleSets/sku.name, Microsoft.Compute/VirtualMachineScaleSets/...
Microsoft.Compute virtualMachineScaleSets/extensions {Microsoft.Compute/virtualMachineScaleSets/extensions/provisioningState, Microsoft.Compute/virt...
PS C:\>
Lista todos os tipos de recursos do provedor cujo namespace corresponde a 'compute' e o tipo de recurso corresponde a 'virtual' e contém um alias. Nota: -NamespaceMatch e -ResourceTypeMatch fornecem correspondências exclusivas, enquanto as outras são inclusivas.
Exemplo 7
PS C:\> Get-AzureRmPolicyAlias -AliasMatch 'virtual'
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.Compute virtualMachines {Microsoft.Compute/licenseType, Microsoft.Compute/virtualMachines/availabilitySet.id, Mi...
Microsoft.Compute virtualMachines/extensions {Microsoft.Compute/virtualMachines/extensions/provisioningState, Microsoft.Compute/virtu...
Microsoft.Compute virtualMachineScaleSets {Microsoft.Compute/VirtualMachineScaleSets/sku.name, Microsoft.Compute/VirtualMachineSca...
Microsoft.Compute virtualMachineScaleSets/extensions {Microsoft.Compute/virtualMachineScaleSets/extensions/provisioningState, Microsoft.Compu...
Microsoft.DocumentDB databaseAccounts {Microsoft.DocumentDB/databaseAccounts/sku.name, Microsoft.DocumentDB/databaseAccounts/v...
Microsoft.HDInsight clusters {Microsoft.HDInsight/clusters/clusterVersion, Microsoft.HDInsight/clusters/osType, Micro...
Microsoft.KeyVault vaults {Microsoft.KeyVault/vaults/sku.name, Microsoft.KeyVault/vaults/sku.family, Microsoft.Key...
Microsoft.Network virtualNetworks {Microsoft.Network/virtualNetworks/subnets[*].routeTable.id, Microsoft.Network/virtualNe...
Microsoft.Network virtualNetworkGateways {Microsoft.Network/virtualNetworkGateways/sku.name, Microsoft.Network/virtualNetworkGate...
Microsoft.Network virtualNetworks/subnets {Microsoft.Network/virtualNetworks/subnets/routeTable.id, Microsoft.Network/virtualNetwo...
Microsoft.Network virtualNetworks/virtualNetworkPeerings {Microsoft.Network/virtualNetworks/virtualNetworkPeerings/remoteVirtualNetwork.id}
Microsoft.Sql servers/virtualNetworkRules {Microsoft.Sql/servers/virtualNetworkRules/virtualNetworkSubnetId, Microsoft.Sql/servers...
Microsoft.Storage storageAccounts {Microsoft.Storage/storageAccounts/accountType, Microsoft.Storage/storageAccounts/sku.na...
PS C:\>
Lista todos os tipos de recursos do provedor que contêm um alias correspondente a 'virtual'.
Exemplo 8
PS C:\> Get-AzureRmPolicyAlias -AliasMatch 'virtual' -PathMatch 'network'
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.Compute virtualMachines {Microsoft.Compute/licenseType, Microsoft.Compute/virtualMachines/availabilitySet.id, Mi...
Microsoft.Compute virtualMachines/extensions {Microsoft.Compute/virtualMachines/extensions/provisioningState, Microsoft.Compute/virtu...
Microsoft.Compute virtualMachineScaleSets {Microsoft.Compute/VirtualMachineScaleSets/sku.name, Microsoft.Compute/VirtualMachineSca...
Microsoft.Compute virtualMachineScaleSets/extensions {Microsoft.Compute/virtualMachineScaleSets/extensions/provisioningState, Microsoft.Compu...
Microsoft.DocumentDB databaseAccounts {Microsoft.DocumentDB/databaseAccounts/sku.name, Microsoft.DocumentDB/databaseAccounts/v...
Microsoft.HDInsight clusters {Microsoft.HDInsight/clusters/clusterVersion, Microsoft.HDInsight/clusters/osType, Micro...
Microsoft.KeyVault vaults {Microsoft.KeyVault/vaults/sku.name, Microsoft.KeyVault/vaults/sku.family, Microsoft.Key...
Microsoft.Network virtualNetworks {Microsoft.Network/virtualNetworks/subnets[*].routeTable.id, Microsoft.Network/virtualNe...
Microsoft.Network networkInterfaces {Microsoft.Network/networkInterfaces/ipconfigurations[*].subnet.id, Microsoft.Network/ne...
Microsoft.Network networkSecurityGroups {Microsoft.Network/networkSecurityGroups/securityRules[*].protocol, Microsoft.Network/ne...
Microsoft.Network virtualNetworkGateways {Microsoft.Network/virtualNetworkGateways/sku.name, Microsoft.Network/virtualNetworkGate...
Microsoft.Network virtualNetworks/subnets {Microsoft.Network/virtualNetworks/subnets/routeTable.id, Microsoft.Network/virtualNetwo...
Microsoft.Network virtualNetworks/virtualNetworkPeerings {Microsoft.Network/virtualNetworks/virtualNetworkPeerings/remoteVirtualNetwork.id}
Microsoft.Sql servers/virtualNetworkRules {Microsoft.Sql/servers/virtualNetworkRules/virtualNetworkSubnetId, Microsoft.Sql/servers...
Microsoft.Storage storageAccounts {Microsoft.Storage/storageAccounts/accountType, Microsoft.Storage/storageAccounts/sku.na...
PS C:\>
Lista todos os tipos de recursos do provedor que contêm um alias correspondente a 'virtual' ou um alias com um caminho correspondente a 'rede'.
Exemplo 9
PS C:\> Get-AzureRmPolicyAlias -ApiVersionMatch 'alpha'
Namespace ResourceType Aliases
--------- ------------ -------
Microsoft.Cache Redis {Microsoft.Cache/Redis/sku.name, Microsoft.Cache/Redis/sku.family, Microsoft.Cache/Redis/sku.capacity, Micros...
Microsoft.Cache Redis/firewallrules {Microsoft.Cache/Redis/firewallrules/startIP, Microsoft.Cache/Redis/firewallrules/endIP}
Microsoft.Security alerts {Microsoft.Security/alerts/state}
Microsoft.Security pricings {Microsoft.Security/pricings/pricingTier}
Microsoft.Security complianceResults {Microsoft.Security/complianceResults/resourceStatus}
PS C:\>
Lista todos os tipos de recursos do provedor com a versão da api alfa ou que contém um alias com uma versão da api alfa.
Parâmetros
-AliasMatch
Inclui na saída itens com aliases cujo nome corresponde a esse valor.
Type: | String |
Aliases: | Alias |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApiVersion
Quando definido, indica a versão da API do provedor de recursos a ser usada. Se não for especificada, a versão da API será determinada automaticamente como a mais recente disponível.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApiVersionMatch
Inclui na saída itens cujos tipos de recursos ou aliases têm uma versão de api correspondente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ListAvailable
Inclui na saída itens correspondentes com e sem aliases.
Type: | SwitchParameter |
Aliases: | ShowAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocationMatch
Inclui na saída itens cujos tipos de recursos têm um local correspondente.
Type: | String |
Aliases: | Location |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NamespaceMatch
Limita a saída a itens cujo namespace corresponde a esse valor.
Type: | String |
Aliases: | Name, Namespace |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PathMatch
Inclui na saída itens com aliases contendo um caminho que corresponde a esse valor.
Type: | String |
Aliases: | Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Quando definido, indica que o cmdlet deve usar versões de API de pré-lançamento ao determinar automaticamente qual versão usar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceTypeMatch
Limita a saída a itens cujo tipo de recurso corresponde a esse valor.
Type: | String |
Aliases: | ResourceType, Resource |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
Observações
Para expandir os Aliases ou qualquer outra propriedade, canalize a saída para
select -ExpandProperty <property>
. Por exemplo:Get-AzureRmPolicyAlias -NamespaceMatch 'Microsoft.Cache' -ApiVersionMatch 'alpha' | select -ExpandProperty Aliases | select -Property Name -ExpandProperty Paths
Propriedades adicionais estão disponíveis na saída e podem ser exibidas canalizando a saída para
Format-List
. Por exemplo:Get-AzureRmPolicyAlias -NamespaceMatch 'Web' -ResourceTypeMatch site -PathMatch cert | Format-List