Ejemplos de AWS Config con las Herramientas para PowerShell V4

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V4 con AWS Config.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Temas

Acciones

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Add-CFGResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la etiqueta especificada al ARN del recurso, que en este caso es config-rule/config-rule-16iyn0.


Add-CFGResourceTag -ResourceArn arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-16iyn0 -Tag @{Key="Release";Value="Beta"}

Para obtener información sobre la API, consulte TagResource en la Referencia de Cmdlet de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateComplianceByConfigRuleList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se obtienen los detalles del filtrado “kaju” de ConfigurationAggregator para la regla de configuración especificada y se amplía o devuelve la “conformidad” de la regla.


Get-CFGAggregateComplianceByConfigRuleList -ConfigurationAggregatorName kaju -Filters_ConfigRuleName ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK | Select-Object -ExpandProperty Compliance

Salida:


ComplianceContributorCount                            ComplianceType
--------------------------                            --------------
Amazon.ConfigService.Model.ComplianceContributorCount NON_COMPLIANT

Ejemplo 2: En este ejemplo, se obtienen los detalles del ConfigurationAggregator especificado, los filtra para la cuenta especificada en todas las regiones incluidas en el agregador y, además, se devuelve la conformidad de todas las reglas.


Get-CFGAggregateComplianceByConfigRuleList -ConfigurationAggregatorName kaju -Filters_AccountId 123456789012 | Select-Object ConfigRuleName, @{N="Compliance";E={$_.Compliance.ComplianceType}}

Salida:


ConfigRuleName                      Compliance
--------------                      ----------
ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK NON_COMPLIANT
ec2-instance-no-public-ip           NON_COMPLIANT
desired-instance-type               NON_COMPLIANT

Para obtener información sobre la API, consulte DescribeAggregateComplianceByConfigRules en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateComplianceDetailsByConfigRule.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se devuelven los resultados de la evaluación al seleccionar el resultado con el resource-id y el resource-type para la regla de configuración de AWS “desired-instance-type”, que tiene el estado “COMPLIANT” para la cuenta, el agregador, la región y la regla de configuración especificados.


Get-CFGAggregateComplianceDetailsByConfigRule -AccountId 123456789012 -AwsRegion eu-west-1 -ComplianceType COMPLIANT -ConfigRuleName desired-instance-type -ConfigurationAggregatorName raju | Select-Object -ExpandProperty EvaluationResultIdentifier | Select-Object -ExpandProperty EvaluationResultQualifier

Salida:


ConfigRuleName        ResourceId          ResourceType
--------------        ----------          ------------
desired-instance-type i-0f1bf2f34c5678d12 AWS::EC2::Instance
desired-instance-type i-0fd12dd3456789123 AWS::EC2::Instance

Para obtener información sobre la API, consulte GetAggregateComplianceDetailsByConfigRule en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateConfigRuleComplianceSummary.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelve el número de reglas no conformes del agregador especificado.


(Get-CFGAggregateConfigRuleComplianceSummary -ConfigurationAggregatorName raju).AggregateComplianceCounts.ComplianceSummary.NonCompliantResourceCount

Salida:


CapExceeded CappedCount
----------- -----------
False       5

Para obtener información sobre la API, consulte GetAggregateConfigRuleComplianceSummary en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateDiscoveredResourceCount.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelve el número de recursos del agregador especificado filtrado para la región us-east-1.


Get-CFGAggregateDiscoveredResourceCount -ConfigurationAggregatorName Master -Filters_Region us-east-1

Salida:


GroupByKey GroupedResourceCounts NextToken TotalDiscoveredResources
---------- --------------------- --------- ------------------------
           {}                              455

Ejemplo 2: En este ejemplo se devuelve el número de recursos agrupados por RESOURCE_TYPE de la región filtrada para el agregador especificado.


Get-CFGAggregateDiscoveredResourceCount -ConfigurationAggregatorName Master -Filters_Region us-east-1 -GroupByKey RESOURCE_TYPE | 
			Select-Object -ExpandProperty GroupedResourceCounts

Salida:


GroupName                          ResourceCount
---------                          -------------
AWS::CloudFormation::Stack         12
AWS::CloudFront::Distribution      1
AWS::CloudTrail::Trail             1
AWS::DynamoDB::Table               1
AWS::EC2::EIP                      2
AWS::EC2::FlowLog                  2
AWS::EC2::InternetGateway          4
AWS::EC2::NatGateway               2
AWS::EC2::NetworkAcl               4
AWS::EC2::NetworkInterface         12
AWS::EC2::RouteTable               13
AWS::EC2::SecurityGroup            18
AWS::EC2::Subnet                   16
AWS::EC2::VPC                      4
AWS::EC2::VPCEndpoint              2
AWS::EC2::VPCPeeringConnection     1
AWS::IAM::Group                    2
AWS::IAM::Policy                   51
AWS::IAM::Role                     78
AWS::IAM::User                     7
AWS::Lambda::Function              3
AWS::RDS::DBSecurityGroup          1
AWS::S3::Bucket                    3
AWS::SSM::AssociationCompliance    107
AWS::SSM::ManagedInstanceInventory 108

Para obtener información sobre la API, consulte GetAggregateDiscoveredResourceCounts en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateDiscoveredResourceList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelven los identificadores de recursos para el tipo de recurso especificado agregado en el agregador “Ireland”. Para ver la lista de tipos de recursos, consulte https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=ConfigService/TConfigServiceResourceType.html&tocid=Amazon_ConfigService_ResourceType.


Get-CFGAggregateDiscoveredResourceList -ConfigurationAggregatorName Ireland -ResourceType ([Amazon.ConfigService.ResourceType]::AWSAutoScalingAutoScalingGroup)

Salida:


ResourceId      : arn:aws:autoscaling:eu-west-1:123456789012:autoScalingGroup:12e3b4fc-1234-1234-a123-1d2ba3c45678:autoScalingGroupName/asg-1
ResourceName    : asg-1
ResourceType    : AWS::AutoScaling::AutoScalingGroup
SourceAccountId : 123456789012
SourceRegion    : eu-west-1

Ejemplo 2: En este ejemplo se devuelve el tipo de recurso AwsEC2SecurityGroup llamado “default” del agregador especificado filtrado con la región us-east-1.


Get-CFGAggregateDiscoveredResourceList -ConfigurationAggregatorName raju -ResourceType ([Amazon.ConfigService.ResourceType]::AWSEC2SecurityGroup) -Filters_Region us-east-1 -Filters_ResourceName default

Salida:


ResourceId      : sg-01234bd5dbfa67c89
ResourceName    : default
ResourceType    : AWS::EC2::SecurityGroup
SourceAccountId : 123456789102
SourceRegion    : us-east-1

ResourceId      : sg-0123a4ebbf56789be
ResourceName    : default
ResourceType    : AWS::EC2::SecurityGroup
SourceAccountId : 123456789102
SourceRegion    : us-east-1

ResourceId      : sg-4fc1d234
ResourceName    : default
ResourceType    : AWS::EC2::SecurityGroup
SourceAccountId : 123456789102
SourceRegion    : us-east-1

Para obtener información sobre la API, consulte ListAggregateDiscoveredResources en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateResourceConfig.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelve el elemento de configuración del recurso especificado agregado y se expande la configuración.


(Get-CFGAggregateResourceConfig -ResourceIdentifier_SourceRegion us-east-1 -ResourceIdentifier_SourceAccountId 123456789012 -ResourceIdentifier_ResourceId sg-4fc1d234 -ResourceIdentifier_ResourceType ([Amazon.ConfigService.ResourceType]::AWSEC2SecurityGroup) -ConfigurationAggregatorName raju).Configuration | ConvertFrom-Json

Salida:


{"description":"default VPC security group","groupName":"default","ipPermissions":[{"ipProtocol":"-1","ipv6Ranges":[],"prefixListIds":[],"userIdGroupPairs":[{"groupId":"sg-4fc1d234","userId":"123456789012"}],"ipv4Ranges":[],"ipRanges":[]},{"fromPort":3389,"ipProtocol":"tcp","ipv6Ranges":[],"prefixListIds":[],"toPort":3389,"userIdGroupPairs":[],"ipv4Ranges":[{"cidrIp":"54.240.197.224/29","description":"office subnet"},{"cidrIp":"72.21.198.65/32","description":"home pc"}],"ipRanges":["54.240.197.224/29","72.21.198.65/32"]}],"ownerId":"123456789012","groupId":"sg-4fc1d234","ipPermissionsEgress":[{"ipProtocol":"-1","ipv6Ranges":[],"prefixListIds":[],"userIdGroupPairs":[],"ipv4Ranges":[{"cidrIp":"0.0.0.0/0"}],"ipRanges":["0.0.0.0/0"]}],"tags":[],"vpcId":"vpc-2d1c2e34"}

Para obtener información sobre la API, consulte GetAggregateResourceconfig-service en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregateResourceConfigBatch.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene el elemento de configuración actual del recurso (identificado) presente en el agregador especificado.


$resIdentifier=[Amazon.ConfigService.Model.AggregateResourceIdentifier]@{
		ResourceId= "i-012e3cb4df567e8aa"
		ResourceName = "arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa"
		ResourceType = [Amazon.ConfigService.ResourceType]::AWSEC2Instance
		SourceAccountId = "123456789012"
		SourceRegion = "eu-west-1"
	}
		
	Get-CFGAggregateResourceConfigBatch -ResourceIdentifier $resIdentifier -ConfigurationAggregatorName raju

Salida:


BaseConfigurationItems UnprocessedResourceIdentifiers
---------------------- ------------------------------
{}                     {arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa}

Para obtener información sobre la API, consulte BatchGetAggregateResourceconfig-service en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGAggregationAuthorizationList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se recuperan las autorizaciones concedidas a los agregadores.


Get-CFGAggregationAuthorizationList

Salida:


AggregationAuthorizationArn                                                            AuthorizedAccountId AuthorizedAwsRegion CreationTime
---------------------------                                                            ------------------- ------------------- ------------
arn:aws:config-service:eu-west-1:123456789012:aggregation-authorization/123456789012/eu-west-1 123456789012        eu-west-1           8/26/2019 12:55:27 AM

Para obtener información sobre la API, consulte DescribeAggregationAuthorizations en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGComplianceByConfigRule.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo recupera los detalles de conformidad de la regla ebs-optimized-instance, para la que no hay resultados de evaluación actuales, por lo que devuelve INSUFFICIENT_DATA


(Get-CFGComplianceByConfigRule -ConfigRuleName ebs-optimized-instance).Compliance

Salida:


ComplianceContributorCount ComplianceType
-------------------------- --------------
                           INSUFFICIENT_DATA

Ejemplo 2: Este ejemplo devuelve el número de recursos no conformes para la regla ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK.


(Get-CFGComplianceByConfigRule -ConfigRuleName ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK -ComplianceType NON_COMPLIANT).Compliance.ComplianceContributorCount

Salida:


CapExceeded CappedCount
----------- -----------
False       2

Para obtener información sobre la API, consulte DescribeComplianceByConfigRule en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGComplianceByResource.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se revisa el tipo de recurso AWS::SSM::ManagedInstanceInventory para el tipo de cumplimiento COMPLIANT.


Get-CFGComplianceByResource -ComplianceType COMPLIANT -ResourceType AWS::SSM::ManagedInstanceInventory

Salida:


Compliance                            ResourceId          ResourceType
----------                            ----------          ------------
Amazon.ConfigService.Model.Compliance i-0123bcf4b567890e3 AWS::SSM::ManagedInstanceInventory
Amazon.ConfigService.Model.Compliance i-0a1234f6f5d6b78f7 AWS::SSM::ManagedInstanceInventory

Para obtener información sobre la API, consulte DescribeComplianceByResource en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGComplianceDetailsByConfigRule.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se obtienen los resultados de la evaluación de la regla access-keys-rotated, y se devuelve el resultado agrupado por tipo de conformidad


Get-CFGComplianceDetailsByConfigRule -ConfigRuleName access-keys-rotated | Group-Object ComplianceType

Salida:


Count Name                      Group
----- ----                      -----
    2 COMPLIANT                 {Amazon.ConfigService.Model.EvaluationResult, Amazon.ConfigService.Model.EvaluationResult}
    5 NON_COMPLIANT             {Amazon.ConfigService.Model.EvaluationResult, Amazon.ConfigService.Model.EvaluationResult, Amazon.ConfigService.Model.EvaluationRes...

Ejemplo 2: En este ejemplo, se consultan los detalles de cumplimiento de la regla access-keys-rotated para los recursos COMPLIANT.


Get-CFGComplianceDetailsByConfigRule -ConfigRuleName access-keys-rotated -ComplianceType COMPLIANT | ForEach-Object {$_.EvaluationResultIdentifier.EvaluationResultQualifier}

Salida:


ConfigRuleName      ResourceId            ResourceType
--------------      ----------            ------------
access-keys-rotated BCAB1CDJ2LITAPVEW3JAH AWS::IAM::User
access-keys-rotated BCAB1CDJ2LITL3EHREM4Q AWS::IAM::User

Para obtener información sobre la API, consulte GetComplianceDetailsByConfigRule en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGComplianceDetailsByResource.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo devuelve los resultados de la evaluación de un recurso determinado.


Get-CFGComplianceDetailsByResource -ResourceId ABCD5STJ4EFGHIVEW6JAH -ResourceType 'AWS::IAM::User'

Salida:


Annotation                 :
ComplianceType             : COMPLIANT
ConfigRuleInvokedTime      : 8/25/2019 11:34:56 PM
EvaluationResultIdentifier : Amazon.ConfigService.Model.EvaluationResultIdentifier
ResultRecordedTime         : 8/25/2019 11:34:56 PM
ResultToken                :

Para obtener información sobre la API, consulte GetComplianceDetailsByResource en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGComplianceSummaryByConfigRule.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo devuelve el número de reglas de Config que no son conformes.


Get-CFGComplianceSummaryByConfigRule -Select ComplianceSummary.NonCompliantResourceCount

Salida:


CapExceeded CappedCount
----------- -----------
False       9

Para obtener información sobre la API, consulte GetComplianceSummaryByConfigRule en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGComplianceSummaryByResourceType.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se devuelve el número de recursos conformes y no conformes, y se convierte el resultado en json.


Get-CFGComplianceSummaryByResourceType -Select ComplianceSummariesByResourceType.ComplianceSummary | ConvertTo-Json
{
  "ComplianceSummaryTimestamp": "2019-12-14T06:14:49.778Z",
  "CompliantResourceCount": {
    "CapExceeded": false,
    "CappedCount": 2
  },
  "NonCompliantResourceCount": {
    "CapExceeded": true,
    "CappedCount": 100
  }
}

Para obtener información sobre la API, consulte GetComplianceSummaryByResourceType en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConfigRule.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se enumeran las reglas de configuración de la cuenta, con las propiedades seleccionadas.


Get-CFGConfigRule | Select-Object ConfigRuleName, ConfigRuleId, ConfigRuleArn, ConfigRuleState

Salida:


ConfigRuleName                                    ConfigRuleId       ConfigRuleArn                                                        ConfigRuleState
--------------                                    ------------       -------------                                                        ---------------
ALB_REDIRECTION_CHECK                             config-rule-12iyn3 arn:aws:config-service:eu-west-1:123456789012:config-rule/config-rule-12iyn3 ACTIVE
access-keys-rotated                               config-rule-aospfr arn:aws:config-service:eu-west-1:123456789012:config-rule/config-rule-aospfr ACTIVE
autoscaling-group-elb-healthcheck-required        config-rule-cn1f2x arn:aws:config-service:eu-west-1:123456789012:config-rule/config-rule-cn1f2x ACTIVE

Para obtener información sobre la API, consulte DescribeConfigRules en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConfigRuleEvaluationStatus.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo devuelve la información de estado de las reglas de configuración correspondientes.


Get-CFGConfigRuleEvaluationStatus -ConfigRuleName root-account-mfa-enabled, vpc-flow-logs-enabled

Salida:


ConfigRuleArn                : arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-kvq1wk
ConfigRuleId                 : config-rule-kvq1wk
ConfigRuleName               : root-account-mfa-enabled
FirstActivatedTime           : 8/27/2019 8:05:17 AM
FirstEvaluationStarted       : True
LastErrorCode                :
LastErrorMessage             :
LastFailedEvaluationTime     : 1/1/0001 12:00:00 AM
LastFailedInvocationTime     : 1/1/0001 12:00:00 AM
LastSuccessfulEvaluationTime : 12/13/2019 8:12:03 AM
LastSuccessfulInvocationTime : 12/13/2019 8:12:03 AM

ConfigRuleArn                : arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-z1s23b
ConfigRuleId                 : config-rule-z1s23b
ConfigRuleName               : vpc-flow-logs-enabled
FirstActivatedTime           : 8/14/2019 6:23:44 AM
FirstEvaluationStarted       : True
LastErrorCode                :
LastErrorMessage             :
LastFailedEvaluationTime     : 1/1/0001 12:00:00 AM
LastFailedInvocationTime     : 1/1/0001 12:00:00 AM
LastSuccessfulEvaluationTime : 12/13/2019 7:12:01 AM
LastSuccessfulInvocationTime : 12/13/2019 7:12:01 AM

Para obtener información sobre la API, consulte DescribeConfigRuleEvaluationStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConfigurationAggregatorList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelven todos los agregadores de la región o de la cuenta.


Get-CFGConfigurationAggregatorList

Salida:


AccountAggregationSources     : {Amazon.ConfigService.Model.AccountAggregationSource}
ConfigurationAggregatorArn    : arn:aws:config-service:eu-west-1:123456789012:config-aggregator/config-aggregator-xabca1me
ConfigurationAggregatorName   : IrelandMaster
CreationTime                  : 8/25/2019 11:42:39 PM
LastUpdatedTime               : 8/25/2019 11:42:39 PM
OrganizationAggregationSource :

AccountAggregationSources     : {}
ConfigurationAggregatorArn    : arn:aws:config-service:eu-west-1:123456789012:config-aggregator/config-aggregator-qubqabcd
ConfigurationAggregatorName   : raju
CreationTime                  : 8/11/2019 8:39:25 AM
LastUpdatedTime               : 8/11/2019 8:39:25 AM
OrganizationAggregationSource : Amazon.ConfigService.Model.OrganizationAggregationSource

Para obtener información sobre la API, consulte DescribeConfigurationAggregators en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConfigurationAggregatorSourcesStatus.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se muestran los campos solicitados para las fuentes del agregador especificado.


Get-CFGConfigurationAggregatorSourcesStatus -ConfigurationAggregatorName raju | select SourceType, LastUpdateStatus, LastUpdateTime, SourceId

Salida:


SourceType   LastUpdateStatus LastUpdateTime        SourceId
----------   ---------------- --------------        --------
ORGANIZATION SUCCEEDED        12/31/2019 7:45:06 AM Organization
ACCOUNT      SUCCEEDED        12/31/2019 7:09:38 AM 612641234567
ACCOUNT      SUCCEEDED        12/31/2019 7:12:53 AM 933301234567
ACCOUNT      SUCCEEDED        12/31/2019 7:18:10 AM 933301234567
ACCOUNT      SUCCEEDED        12/31/2019 7:25:17 AM 933301234567
ACCOUNT      SUCCEEDED        12/31/2019 7:25:49 AM 612641234567
ACCOUNT      SUCCEEDED        12/31/2019 7:26:11 AM 612641234567

Para obtener información sobre la API, consulte DescribeConfigurationAggregatorSourcesStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConfigurationRecorder.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo devuelve información sobre los registros de configuración.


Get-CFGConfigurationRecorder | Format-List

Salida:


Name           : default
RecordingGroup : Amazon.ConfigService.Model.RecordingGroup
RoleARN        : arn:aws:iam::123456789012:role/aws-service-role/config.amazonaws.com/AWSServiceRoleForConfig

Para obtener información sobre la API, consulte DescribeConfigurationRecorders en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConfigurationRecorderStatus.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo devuelve el estado de los registros de configuración.


Get-CFGConfigurationRecorderStatus

Salida:


LastErrorCode        :
LastErrorMessage     :
LastStartTime        : 10/11/2019 10:13:51 AM
LastStatus           : Success
LastStatusChangeTime : 12/31/2019 6:14:12 AM
LastStopTime         : 10/11/2019 10:13:46 AM
Name                 : default
Recording            : True

Para obtener información sobre la API, consulte DescribeConfigurationRecorderStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGConformancePack.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se enumeran todos los paquetes de conformidad.


Get-CFGConformancePack

Salida:


ConformancePackArn             : arn:aws:config:eu-west-1:123456789012:conformance-pack/dono/conformance-pack-p0acq8bpz
ConformancePackId              : conformance-pack-p0acabcde
ConformancePackInputParameters : {}
ConformancePackName            : dono
CreatedBy                      :
DeliveryS3Bucket               : kt-ps-examples
DeliveryS3KeyPrefix            :
LastUpdateRequestedTime        : 12/31/2019 8:45:31 AM

Para obtener información sobre la API, consulte DescribeConformancePacks en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGDeliveryChannel.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se recupera el canal de entrega de la región y se muestran los detalles.


Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}

Salida:


Name    S3BucketName               S3KeyPrefix DeliveryFrequency
----    ------------               ----------- -----------------
default config-bucket-NA my          TwentyFour_Hours

Para obtener información sobre la API, consulte DescribeDeliveryChannels en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CFGResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se enumeran las etiquetas asociadas del recurso especificado


Get-CFGResourceTag -ResourceArn $rules[0].ConfigRuleArn

Salida:


Key     Value
---     -----
Version 1.3

Para obtener información sobre la API, consulte ListTagsForResource en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-CFGConformancePack.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el paquete de conformidad especificado, junto con todas las reglas, las acciones correctivas y los resultados de la evaluación del paquete.


Remove-CFGConformancePack -ConformancePackName dono

Salida:


Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-CFGConformancePack (DeleteConformancePack)" on target "dono".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Para obtener información sobre la API, consulte DeleteConformancePack en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Write-CFGConformancePack.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un paquete de conformidad y se obtiene la plantilla del archivo yaml especificado.


Write-CFGConformancePack -ConformancePackName dono -DeliveryS3Bucket amzn-s3-demo-bucket -TemplateBody (Get-Content C:\windows\temp\template.yaml -Raw)

Para obtener información sobre la API, consulte PutConformancePack en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Write-CFGDeliveryChannel.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se cambia la propiedad deliveryFrequency de un canal de entrega existente.


Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my

Para obtener información sobre la API, consulte PutDeliveryChannel en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Amazon Cognito Identity

Device Farm