< Back

Add-GceAddress

Mon Jan 13, 2020 10:56 pm

NAME Add-GceAddress



SYNOPSIS

Adds a new address.





SYNTAX

Add-GceAddress [-Project <string>] [-Region <string>] [-Object] <Address> [<CommonParameters>]



Add-GceAddress [-Project <string>] [-Region <string>] [-Name] <string> [[-Description] <string>]

[<CommonParameters>]



Add-GceAddress [-Project <string>] [-Object] <Address> -Global <SwitchParameter> [<CommonParameters>]



Add-GceAddress [-Project <string>] [-Name] <string> [[-Description] <string>] -Global <SwitchParameter>

[<CommonParameters>]





DESCRIPTION

Adds a new static external IP address to Google Compute Engine.





PARAMETERS

-Project <string>

The project that will own the address. Will default to the gcloud config.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Region <string>

The region the address will be in. For non-global addresses, will default to the gcloud config.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Object <Address>

The Google.Apis.Compute.v1.Data.Address object with the information used to create an address.



Required? true

Position? 0

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Name <string>

The name of the address to create. Must comply with RFC1035.



Required? true

Position? 0

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Description <string>

Human readable description of the address.



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Global <SwitchParameter>

If set, will create a global address, rather than a region specific one.



Required? true

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Google.Apis.Compute.v1.Data.Address

The Google.Apis.Compute.v1.Data.Address object with the information used to create an address.



System.String

The name of the address to create. Must comply with RFC1035.





OUTPUTS

Google.Apis.Compute.v1.Data.Address





---------- EXAMPLE 1 ----------



Add-GceAddress $addressName



Adds an address to the default project and region:

---------- EXAMPLE 2 ----------



Add-GceAddress $addressName -Global



Adds a global address to the default project.



RELATED LINKS

[Address resource definition] (https://cloud.google.com/compute/docs/r ... s#resource)